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PREFACE 


This reference publication is intended for programmers using the MRX/OS Assembler 
Language. This publication describes how to write assembler source statements, including 
assembler instructions, macro instructions, and conditional assembly statements. These 
instructions are summarized in Appendix E. Machine instructions and extended mnemonic 
codes are summarized in Section 3, and additional reference tables appear in Appendixes B, 
C, and D. The machine instructions are described in detail in the publication 7200 or 7300 
Processing Unit Reference. 
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l. INTRODUCTION 


FUNCTION OF THE ASSEMBLER 


The MRX/OS Assembler consists of a language and an assembler program. The language is a 
set of codes and coding rules for writing a source program. The assembler program translates 
the source program into an object program that can be executed by the system. The object 
program produced by the assembler is in the form of relocatable object modules. This 
translation process is called an assembly. | 


Two types of source statements can be expressed in the assembler language, machine 
instructions and assembler instructions. 


The machine instruction source statements provide mnemonic codes for all machine 
instructions in the MRX 40/50 instruction set. Extended mnemonic codes are also provided 
for the skip and branch instructions. Section 3 of this manual describes the general format 
of the machine instructions. A complete description of the machine instructions, addressing 
techniques, and data representation is in the manual 7200 or 7300 Processing Unit 
Reference. 


The assembler instruction source statements specify auxiliary functions to be performed by 
the assembler program. These functions include: 


e Checking and documenting programs 

e Controlling address assignment 

e Segmenting programs 

e Defining data and symbols 

@ Generating macro and form instructions 

e Controlling the assembly process through conditional assembly 
statements 


The macro facility enables the programmer to define and use macro instructions. A macro 
instruction is represented by an operation code which, in turn, stands for a sequence of 
statements that accomplish the desired function. 


Conditional assembly statements affect the order of source statement assembly and macro 
generation, or the content of generated statements. 
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A listing of the source program statements and the resulting object program statements may 
be produced with programmer control of form and content. A cross-reference list of symbol 
definitions and references is also produced unless suppressed by the programmer. Errors 
detected during assembly are indicated in the program listing. Warning errors may be 
suppressed. 


RELATIONSHIP TO THE OPERATING SYSTEM 


The assembler program is a component of the MRX 40/50 operating system and operates 
under its control. The operating system provides the assembler program with input/output, 
segment loading, library, and other services needed for its proper functioning. The assembler 
program is called through Contro! Language statements and resides in a user partition during 
execution. 


SYSTEM REQUIREMENTS 


The MRX 40/50 System equipment configuration required to execute the assembler 
program is as follows. 


e 16K bytes of main storage, of which at least 8K bytes must be 
available to the assembler (additional storage, up to 24K, will 
increase the performance of the assembler) 


e One source input device or data set 
e One list device or data set 

® One operator console 

e One 660 disc storage drive 

e The standard instruction set 
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2. WRITING SOURCE STATEMENTS 


To write source statements, the programmer should be familiar with the following topics: 


8 Character set 

® Basic format of source statements 
© Types of terms and expressions 

e Coding form 


CHARACTER SET 


Source statements may contain the following characters: 


Letters 


A through Z, and $ 


Digits 0 through 9 


Special 
Characters 


The EBCDIC formats and card punch codes for these characters are listed in Appendix A. 
Any of the 256 punch combinations may appear inside a character constant, in comments, 
or in macro instruction operands. The meanings of these characters, and combinations of 
these characters, are explained in Figure 2-1. 
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Character 
A through Z, and $ 


0 through 9 


P’ 


blank 


Explanation 
Used in symbols and character string constants 


Used in numeric constants and symbols 


Operand or suboperand separator 


Indicates a literal term or a keyword parameter 
value 


Defines a character constant (all characters to 
the next apostrophe) 


Defines a hexadecimal string constant (all hexa- 
decimal characters to the next apostraphe) 


Defines a packed decimal string constant (all 
characters to the next apostrophe) 


Defines a zoned decimal string constant (all 
characters to the next apostrophe) 

Defines an integer string constant (all 
characters to the next apostrophe) 


Defines a hexadecimal arithmetic constant 


Define relational (EQ, GT, LT, NE, LE, GE) 
and logical (NOT, AND, OR, EOR) operations 


Defines a reference to a symbol! length 
attribute 


Location counter reference or multiplication 
indicator 


Division indicator (Note that 1/2=0 because 
division always results in an integer, not a 
fraction.) 

Addition Indicator 
Subtraction Indicator 
Defines a variable symbol 

Separates an address-modifying index from the 
rest of the address, delimits sublisted operands, 
or encloses operands or suboperands 

Used for sequence symbols and concatenation 
Used for macro definition comments 

The character following this symbol is to be 
evaluated for its literal value, not for its special 
function. In the example, the symbol following 
the # sign is a semicolon, not a continuation 
indicator. 

Continuation indicator 


Indirect Addressing 


field separator 


Figure 2-1. Character Usage 
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Example 
C’ACCOUNT NO.’ 
TAG3,5825 
HERE, THERE 


=At+2 


C’ABC' 


X'1AFEE’ 


P’425' 


Z'-44’ 


1'4286' 


“FFIA 


A<EQ>B 
A<AND>B 


L'SYMX 
44 
12*20 
10/0 
TAG/B 
TAG+12 
TAB-4 
&TAC 


PAG(R2) 


«LAST 
-* COMMENT 


C’'24 #1 :4’ 


THE STATEMENT IS; 
@REG1,@TAG1 


ADDR 3,4 


BASIC FORMAT OF SOURCE STATEMENTS 


Source program statements have the fields outlined in Figure 2-2. 


Operation Operand Comment 


Machine instruction, Single expression, Informational material 
assembler instruction, several expressions, or blank 

macro instruction, or or blank 

FORM instruction 


Any symbol 
or blank 


Figure 2-2. Source Statement Format 


The name field entry is a symbol used to identify a statement. The name field is necessary 
for certain statements, or when the statement is referred to in another statement, such as in 
a Branch instruction. 


The operation field entry is a predefined mnemonic code (or mnemonic) which identifies 
the function of a machine, macro, assembler, or FORM instruction. Mnemonics are designed 
to be easily learned and remembered; for example, ADDR for Add Register-Register, or 
EQU for an Equate assembler instruction. 


The operand field entry defines or identifies the data involved in the operation. Most 
statements have one or more operands, although some statements have no operands at all. 
Each operand has one or more terms, which may be used in a combination to form one or 
more expressions. (Refer to immediately following text for a discussion of terms and 
expressions.) An operand field may not have more than 35 terms. Operands of machine 
statements generally represent storage locations, general registers, immediate data, or 
constant values. Operands of assembler statements provide the information necessary for the 
assembler to perform the designated operation. 


The optional comment field contains any informational material the programmer wishes to 
add. 

TERMS AND EXPRESSIONS 

A term is a symbol, character, or number that represents a value; an expression is a single 


term or a combination of terms. An expression is used in the operand field of a source 
statement. The following text fully defines terms and expressions. . 
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TERMS 


Every term represents a value; the value may be assigned by the assembler program (symbol, 
symbol length attribute, location counter reference) or may be inherent in the term itself 
(constant, literal). 


An arithmetic combination of terms is reduced to a single arithmetic value by the assembler. 
An arithmetic value is represented as a 16-bit binary value in two’s complement form. A 
logical value has a range of O through 65,535; and an arithmetic value has a range of -32,768 
through 32,767. Limitations on the value of an expression depend on its use. For example, a 
term designating a general register must have a value between 0-7 inclusively; a term 
representing an address must not exceed the size of storage. 


A term is absolute if its value does not change upon program relocation. It is relocatable if 
its value changes upon program relocation. 


The terms used in assembler statements are outlined in Figure 2-3. An explanation of each 
type of term and the rules for its use are provided in the following text. 


Character String 
Constant C’ABC' 


Hexadecimal String 
Constant X'C49FE’ 


Packed Decimal 
String Constants String Constant P’-244’ 


Zoned Decimal 
String Constant 2'246' 


Integer String 
Constants Constant 1’-323’ 


Decimal Arithmetic 


Arithmeti 
ei: Constant 2316 


Constants 


Hexadecimal Arithmetic 


Constant "QFA 
Ordinary Symbols 
Symbolic Parameter &TAB1 
Symbols Variable Symbols System Variable Symbols &SYSNDX 
Set Symbols &TAB3 


Sequence Symbols 


Location 
Counter 
Reference *.20 


Symbol 
Length 
Attribute L’'TAB1 


Literals =HERE 
Figure 2-3. Types of Terms 
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CONSTANTS 


Constants are terms whose values are inherent in the terms themselves. They specify 
machine values or bit configurations directly, rather than by equating the values to symbols 
and then using symbolic references. Constants represent such program elements as 
immediate data, masks, registers, addresses, and address increments. 


Constants are string or arithmetic. String constants are of variable size; arithmetic constants 
are 16 bits long. Examples of all types of constants are presented in Figure 2-6. 


String Constants 


A string constant can only be used as a single term expression, or in a relational expression. 
In a relational expression, both terms must be of the same type (character, hexadecimal, 
etc.}, for example: C‘ABCE’< LT>C‘&P1’. 


Character String Constant 


A character string constant is written as the letter C followed by a character string enclosed 
in apostrophes, for example: C’STRING’. To represent the literal value of an apostrophe, an 
ampersand, a semicolon, or a pound sign as part of the character constant, the character 
must be immediately preceded by an escape character, which is the pound sign. The length 
of a character constant is equal to the number of characters in the constant, excluding the 
escape characters, which do not appear in storage. 


Examples of character constants are shown in Figure 2-4. In the last example of Figure 2-4, 


the generated code is: THIS CHARACTER STRING HAS MANY SPECIAL CHARACTERS 
INIT: #; '&. 


OPERAND 


17] 18] 19.20 21.22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43.44 45 46 47 48 49 50 51 52 53 54 56 56 57 58 59 60 61 62.63 64 65 66 67 68.69 7071. 
neha sennheiser er nr a lh le 


C' THIS IS A MESSAGE’. Sei di he ak oath a lahat daanitte, ¢ hie 


"THIS. CHARACTER ee ep emties oeee Se ee acy stl 
es CONTINVE SD! a ' x Aco) Beek L a id Be hee & ai E25 AE eh eid i r 1 L FS Re 4 a t 1 a m oo © 2 ca yey} L “i 
TALS CMARACTER STRINGHSIS ) NoT. ‘eonra nue Seth coun Gee oe 


Figure 2-4. Character Constants 
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If the following characters are not preceded by an escape character in a character constant, 
they have the meaning given below: 


Character Meaning 


A character constant is continued on the next line 
Piaget Encloses the characters of a character constant 
Variable symbol 


Next character retains its literal value 


Hexadecimal String Constant 


A hexadecimal string constant is written as the letter X followed by a string of hexadecimal 
digits enclosed in apostrophes, such as: X’C49FE’. Each hexadecimal digit is translated into 
its four-bit equivalent. The maximum size of a hexadecimal string constant is limited to the 
maximum number of digits that can be contained on two coding lines. If an odd number of 
digits is specified, the leftmost four bits in the leftmost byte are set to zero. The implied 
length of the constant is half the number of hexadecimal digits in the constant, rounded to 
the next higher integer. 


Packed Decimal String Constant 


A packed decimal string constant is written as the letter P followed by a signed integer 
number enclosed in apostrophes, such as: P‘’-244’. If the sign is omitted, the number is 
assumed to be positive. Each pair of decimal digits is translated into one byte. The rightmost 
byte of a packed field contains the rightmost digit and the sign. Signs generated are “‘C16” 
for plus, and ‘““D16” for minus. The maximum length of a packed decimal string constant is 
limited to the number of digits that can be contained on two coding lines. 


Zoned Decimal String Constant 


A zoned decimal string constant is written as the letter Z followed by a signed integer 
number enclosed in apostrophes, for example: Z2‘246’. If the sign is omitted, the number is 
assumed to be positive. Each decimal digit is translated into one byte. The rightmost byte 
contains the sign and the rightmost digit. Signs generated are ‘‘C16” for plus, and “‘D16” for 
minus. The maximum length of a zoned decimal string constant is limited to the number of 
digits that can be contained on two coding lines. 


Integer String Constant 


An integer string constant is written as the letter | followed by a signed integer number 
enclosed in apostrophes, such as: |’-246’. If the sign is omitted, the number is assumed to be 
positive. An integer string constant is translated into its four-byte binary equivalent. Integer 
constants consist of 1-10 digits with a value ranging from -231 to 231-1. The constant is 
word aligned when used in a WDD statement or a literal. 
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When string constants define data in storage, truncation and padding of their values is 


performed according to the rules presented in Figure 2-5. 


Constant 
Character 


C'ABC' 


Hexadecimal 


X'10A’ 


Packed 
Decimal! 


P’.24' 


Zoned 
Decimal 


Z2'123' 


Integer 


1-758" 


Explicit Length= 
Implicit Length 


C’ABC'(3)=ABC 


Right justify. 

Zero fill on left if the 
constant contains an 
odd number of digits. 


X'10A'(2)=010A 
Right justify. 

Zero fill on left if the 
constant contains even 
number of digits. 


P’-24'(2)=024D 


2'123'(3)=F1F2C3 


Right justify. 
Propagate sign on left. 


I'-758'(4)=FFFFFDOA 


Explicit Length> 
Implicit Length 


Left justify. 
Blank fill on right. 


C'ABC'(4)=ABC 
Right justify. 
Zero fill on left. 


X'10A'(3)=00010A 


Right justify. 
Zero fill on left. 


P’-24'(3)=00024D 


Right justify. 
Zero fill on left. 


2'123'(4)=FOF1F2C3 


Right justify. 


Propagate sign on left. 


1’-758'(6)= 


FFFFFFFFFDOA 


Explicit Length < 
Implicit Length 


Left justify. 
Truncate on right. 
Warning message is given. 


C'ABC'(2)=AB 
Right justify. 


Truncate on feft. 
Warning message is given. 


X'10A’(1)=0A 


Right justify. 
Truncate on left. 
Warning message is given. 


P'-24'(1)=4D 

Right justify. 

Truncate on left. 
Warning message is given. 
F'123'(2)=F2C3 

Right justify. 

Truncate on left. 


Sign is lost. 
Warning message is given. 


I’-758'(1)=0A 


Figure 2-5. Truncation and Padding of String Constant Values 


Arithmetic Constants 
Arithmetic constants can be used in multi-term expressions. An arithmetic constant is 
assembled as its two-byte binary equivalent. The maximum size of an arithmetic constant is 


216.1. If arithmetic constants are used in statements where an explicit size is specified, 
truncation and padding follow the same rules as those for an integer string constant. 


Decimal Arithmetic Constant 


A decimal arithmetic constant is written as an unsigned integer number of 1-5 digits, for 
example: 20. 


2-7 


Hexadecimal Arithmetic Constant 


A hexadecimal arithmetic constant is written as quotation marks followed by a string of 1-4 


hexadecimal digits, for example: ‘‘2FA. Each hexadecimal digit is assembled as its four-bit 
binary equivalent. 


Example Generated Hexadecimal Code 


Character String C'F12AY9*' C6F1F2C1E8F95C 
c'$z#'# #5 5BE97D7BF5 


C'B’ 


C2 
Hexadecimal String X'C49FE’ OC49FE 
X'F2’ F2 
x'C’ oc 


Packed Decimal String P’14' 014C 
P’'925860’ 0925860C 
P’-2' 2D 
P’-2596' 02596D 


Zoned Decimal String 2114’ F1Cc4 
Z'925860’ FQOF2F5F8F6CO 
Z'-2' D2 
Z’-2596' F2FS5F9D6 

Integer String 14’ 00 00 00 OE 
1°925860' 00 OE 20 A4 
I'-2" FFFFFFFF 
I'-2596' FFFFF5DC 


Decimal Arithmetic 


Hexadecimal Arithmetic 


Figure 2-6. Examples of Assembled Constants 


SYMBOLS 


A symbol is a character or combination of characters used to represent locations or arbitrary 
values. Symbols, through their use in name fields and operands, provide the programmer 


with an efficient way to name and reference a program element. A symbol is defined when 
it appears in the name field of a source statement. 
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In general, symbols must conform to these rules: 
1. The symbol must not have more than eight characters. 


2. The first character must be a letter, a period, a dollar sign, or an 
ampersand (&). 


3: The remaining characters may be digits, letters, or dollar signs. If the 
first character is a period or an ampersand, the second character must 
be a letter or a dollar sign. 


4. The first blank after the start of a symbol terminates that symbol. 
5; Symbol definitions cannot be continued. 


The assembler has three types of symbols: ordinary symbols, variable symbols, and sequence 
symbols. Sequence symbols and variable symbols are used only for the macro language and 
for conditional assembly. 


Ordinary Symbols 


An ordinary symbol consists of 1-8 alphanumeric characters, the first of which must be a 
letter or a dollar sign. Ordinary symbols identify program locations or arbitrary values. The 
value of an ordinary symbol may be absolute or relocatable. Examples of ordinary symbols 
are: 


BETA 
X242 


SENTRYP1 


An ordinary symbol that names an instruction, a storage area, a data definition, or a control 
section is the address of the leftmost byte of the identified field. Address values are 
relocatable terms. The value of an address symbol must not exceed 216-1, 


An ordinary symbol may be defined only once in an assembly. That is, each symbol used as 
the name of a statement must be unique within that assembly. However, a symbol may be 
used more than once in the name field of a COM or CSECT assembler statement, because 
the coding of a control section may be suspended and then resumed at a subsequent point. 
Some statements require that a symbol in the operand field be previously defined. 


During assembly, the assembler assigns a length attribute to all ordinary symbols. The length 
attribute of a symbol is the length, in bytes, of the storage field whose address is represented 
by the symbol. For example, a symbol naming an instruction that occupies four bytes of 
storage has a length attribute of four. 
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Variable Symbols 


A variable symbol is a symbol that is assigned different values by the programmer or the 
assembler. The three types of variable symbols are: 


1. Symbolic parameters — used only in macro definitions; values are 
. assigned by macro instructions. 


2. System variable symbols — used only in macro definitions; values are 
assigned by the assembler. 


3. Set Symbols — used anywhere in the source program; values are . 
assigned by SET or GBL statements. 


Variable symbols consist of an ampersand (&) followed by one to seven alphanumeric 
characters, the first of which must be a letter or a dollar sign. Examples of variable symbols 
are: 


&BETA 
&X24 


&P 1 


Concatenation of Variable Symbols 


When a variable symbol is assembled, the current value assigned to the variable symbol is 
substituted for the variable symbol. If a variable symbol is immediately preceded or 
followed by other characters or by another variable symbol, concatenation of the variable 
symbol with another variable symbol or character occurs. To concatenate a variable symbol 
with a letter, digit, period, or left parenthesis that follows the symbol, a period must 
immediately follow the variable symbol, for example: &VAL.8. The period merely indicates 
the end of the variable symbol and does not appear in the generated code. The size of a 
concatenated symbol is limited only by the maximum statement size. However, the 
generated symbol is limited by the rules which pertain to the generated name, operation, or 
operand field, See Figure 2-7 for examples of the concatenation of variable symbols. 


Assume that the following values have been assigned to these variable symbols: 


&P1 = ROP 
&P2 = 5 
&P3 = @ 

Initial Code Generated Code 
&P1&P2 ROPS 
&P1.8 ROP8 
&P3.R7 @R7 
B.&P2 B.5 
&P1 ROP 
7O3&P2 7035 


Figure 2-7. Concatenation of Variable Symbols 
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Sequence Symbols 


Sequence symbols consist of a period followed by one to seven alphanumeric characters, the 
first of which must be a letter or a dollar sign. Sequence symbols can be used in the name 
field of any statement except MACRO, GBLA, and GBLC, and in the operand field of only 
ADO or AGO statements. The programmer can use sequence symbols to vary the sequence 
in which statements are processed by the assembler. Examples of sequence symbols are: 


«LAST 
-HERE 


LOCATION COUNTER REFERENCE 


A location counter assigns storage addresses to program statements. It is the assembler’s 
equivalent of the instruction counter in the computer. As each machine instruction or data 
area is assembled, the location counter is first adjusted to the proper boundary for the item 
(if adjustment is necessary} and then incremented by the length of the assembled item. 
Thus, it always points to the next available location. If the statement is named by a symbol, 
the value of the symbol is the value of the location counter before addition of the length. 


The assembler maintains a location counter for each control section of the program and 
manipulates each location counter as previously described. Source statements for each 
section are assigned addresses from the location counter for that section. The location 
counter for a given control section assigns locations in storage without regard to assignments 
made within other contro! sections. 


Thus, if a program has multiple control sections, all statements identified as belonging to the 
first control section will be assigned from the location counter for section 1; the statements 
for the second control section will be assigned from the location counter for section 2, etc. 
This procedure is followed whether the statements from different control sections are 
interspersed or written in control section sequence. 


The location counter setting is controlled by using the ORG and ALIGN assembler 
statements. The counter affected by an ORG statement is the counter for the control 
section in which it appears. The maximum value for the location counter is 216-1, 


The programmer can refer to the current location counter by using an asterisk in the 
operand field. The asterisk represents the value of the current location counter at the start 
of the current statement. This value is relocatable. 


An example of the use of the location counter is: 


OPERATION 


NAME OPERAND 


10 11 12:13 14 15 16 17 19 20 21 22 23 24 25 26 27 23 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


iow! Gb a 
a ne Sn eae 


Be, We a aed ate ss RS et eR ee el seco 


If the location counter is at 0100 when this statement is encountered, the following data is 
generated: 


Location Value 
0100 0100 
0102 0100 
0104 0100 


SYMBOL LENGTH ATTRIBUTE 


The length attribute of a symbol may be used as a term by writing L’ followed by the 
symbol, for example: L’SYMX. The length attribute of SYMX is then substituted for the 
term. The length attribute of an ordinary symbol is the length, in bytes, of the storage field 
whose address is represented by the symbol. 


The length attribute of * is invalid. If the operand of an EQU statement is an asterisk or an 
arithmetic constant, the symbol defined by the EQU statement has a length attribute of 
one. In any other context, the length attribute of an arithmetic constant is two. Examples 
of symbol length attributes are shown in Figure 2-8. 


NAME OPERATION OPERAND 


“12.3.4 5 6 7. 8/9] 10 11 1213 14 15 16 17] 18] 19 20 21 22 23 24 25 26 27 28 29 30, 31 32 33 34 35 36.37 3839 40.41 42 43 44 45 46 47 48 49 50 


hc i Ma a I gg Io ly ag cl = [a ene S 


) n= DD. 64, 7 
NUM CARITH ONSTANT). . ete 


iL lEQu. IS 6*10. | 
<- NUNI CARLTH CONSTANT IN EGU STATEMENT)... 


INST} A Copp (SFRUCTION | Ls. 4 BYTES LONG). ae 


lime ek a 


.QU 
 RLLOGe| CLOGATI CTR REF_IN- Eau STATEMENT). primes 


hs a Soret ede ee tt 


wd A fe, oh at a oe an a oe 


| 4 [ee Se Sener - Ae he dB dt 


as oe 


CONS....| [EQN | THIS STRING! ane naa 
IL CONSE. CELEV N CRARAGTERS. . IN STRING). . cosets 
Dara WDD... De apache te a ae 


 L* INTs “CINTEG! STRING. IS 4 BYTES. LONG). | 


po SL dh 7 eee pee Comms Csees men Capps Fe es a ae Oe aan aes Gas Ge a a a 


a a on Ome Sane | A od Bo 2... be kb. ee ne ae ee Oey Cee Neen SOO DaS Oe nee Caney 


Figure 2-8. Examples of Length Attributes 
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LITERALS 


A literal term is used to introduce data into a program. The formats of a literal term are as 
follows. 


=a a = Data value to be generated (required); any legal expression 
except another literal term. 

=a(b,c) b = Length specification (in bytes): a positive absolute expres- 
sion. If omitted, the length specification is the implied size 

=a(b) of the expression. 

_ c = Repetition factor; a positive absolute expression. If omitted, 

=a(,c) a repetition of 1 is assumed. If the size or length is specified 


symbolically, the symbol must have been previously defined. 
Where: . 


Examples of literals are shown in Figure 2-9. 


==C‘ABD' Invalid: literal cannot define another literal. 
=C’ABD'(4,3) Valid: same as =C‘ABD ABD ABD’ 
=A+B/2+4 Valid: implied length is the length of symbol A; implied 


repetition factor is 1. 
=P’-446'(6) Valid: specified tength is 6; implied repetition factor is 1. 


=X‘FFOO'(,3) Valid: implied length is 2; specified repetition factor is 3. 


Figure 2-9, Examples of Literals 


The assembler generates the literal data, stores this data in a literal pool, and places the 
address of the stored data in the operand field of the statement using the literal. The 
position of the literal pool may be controllecl by the programmer with the LTORG 
assembler statement. If LTORG is not specified at the end of a control section, the literal 
pool for that segment is placed at the end of the first control section. 


A literal can be defined at any point in a program by specifying the literal in the operand of 
the statement in which it is used. In contrast, data definition statements define and label 
data, and then the label is used to specify the data. 


A literal may not be combined with any other term, nor may a literal be used as a receiving 
field of a statement that modifies storage. 


Literals are relocatable, because the address of the literal, not the literal itself, is assembled 
into the statement using the literal. 
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If duplicate literals are specified within one literal pool, only one literal is stored. Literals 
are duplicate if their final specifications, size, and repetition factors are identical on a 
character-by-character basis. A literal may be a duplicate even when it appears to be 
different (see examples in Figure 2-10). A literal is a duplicate if it contains no forward 
references and the expressions evaluate to the same value as the corresponding expressions 
of an existing literal. 


A literal which contains a reference to the location counter is stored even if it duplicates 


another literal (see examples). If an expression used in a literal term contains a forward 
reference to a symbol, the symbol is assumed to represent a two-byte value. 


Examples of duplicate literals are shown in Figure 2-10. 


=C’ABC’(4,3) Only one literal is stored. 

=C’ABC'(4,3) 

=C’ABC’ Both literals are stored. 

=X’C1C2C3’ 

=A+B Only one literal is stored if A and B are predefined symbols. 

=Bt+A 

=C<EQ>D Only one literal is stored if C is defined to be equal to D, so that the 
=1 expression is equal to 1. 

=*+10 Both literals are stored 

=*+10 


Figure 2-10. Examples of Duplicate Literals 


EXPRESSIONS 


An expression is defined as one or more terms linked by arithmetic, relational, or logical 
operators. Expressions may be single term or multi-term (see examples below). 


Single Term Expressions Multi-Term Expressions 

29 SYMX+40 

“FO A+B/2+10 

SYMX (X< OR >"‘FOFO)< EQ >(SP2<OR >“FOFO) 
(((A+4)/2+1)*2< AND >"00FF) <EQ >24) 
L’SYMX *+L'BETA 

P’-240' A+B<LE>SUM 
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During assembly, all expressions are resolved to a single value. Figure 2-11 provides an 
explanation of all types of operators. 


The rules for coding expressions within an operand field are as follows. 

1. An expression may not start with an arithmetic, relational, or logical 
operator. However, an expression may begin with a unary operator: 
positive sign (+), negative sign (-), or logical complement (< NOT >). 
A unary operator indicates the state of the numbers it precedes (such 
as negative, positive, or complement), rather than indicating an 
arithmetic operation (such as addition or subtraction). 


2. An expression may not contain two terms in succession. 


3. An expression may not contain two operators in succession, except 
for the logical operator < NOT>, which may follow the logical 
operators <AND>, <OR>,and <EOR>. 


4. A multi-term expression may not contain a literal. 


5. In a multi-term expression, string constants are restricted to 
relational operations. 


EVALUATION OF EXPRESSIONS 

A single term expression has the value of the term involved. 

A multi-term expression is reduced to a single arithmetic value as follows. 
1. Each term is given its value. 


2: Operations are performed from left to right using the following rules 
of precedence: 


a. Unary arithmetic operations: positive (+) and negative (-). 

b. Arithmetic multiplication (*) and division (/). 

c. Arithmetic addition (+) and subtraction (-). 

d. Relational operations (<EQ>, <NE>, <LT>, <GT>, 


<LE>,and <GE>). 


e. Unary logical complement (<NOT>). 
f. Logical product (< AND>). 
g. Logical addition (<OR>) and subtraction (<EOR>). 
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3: The expression is computed to 32 bits, and then truncated to 16 bits 
or less, depending on its contextual use. 


4, Division always yields an integer result. For example, 1/2*10 yields a 
zero result, whereas 10*1/2 yields 5. Division by zero is permitted 
and yields a zero result. 


5. A relational operation yields a binary result of O or 1. If string 
constants are used in relational operations, both relational terms 
must be of the same type; thus, P’246’ <EQ>Z'246' is illegal. 


6. Logical operations are performed on a bit-by-bit basis equivalent to a 
masking operation. A non-zero value is considered true and a zero 
value is considered false. 


Arithmetic Operators 


Figure 2-11. Types of Operators 
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Operator Meaning Example 
+ Addition A+B 
Subtraction 10-C 
Multiplication D*16 
Division 25/X 
Relational Operators 
Operator Meaning 7 Example 
<EQ> Equal to A<EQ>B 
<NE> Not equal to A<NE>B 
<LT> Less than 17<LT>&P1 
<GT> Greater than 69<GT >TAB 
<LE> Less than or equal to 73<LE>M 
<GE> Greater than or equal to "3F<GE>&TAB1 
Logical Operators 
Operator Meaning Example 
<NOT> Logical complement (one’s <NOT>A 
complement) 
Logical product A<AND>B 
Logical addition (inclusive or) A<OR>B 
Logical subtraction (exclusive or) A<EOR>W 


Parentheses are used in the normal role of arithmetic grouping to change the order of 
evaluation. Parenthesized parts of an expression are evaluated before the rest of the terms in 
the expression. In the case of nested parentheses, the innermost parentheses are evaluated 
first. For example, the expression ((A+4)2+1)*B is evaluated as follows, if A=10 and B=3. 


le At4 = 14 giving (14/2+1)*B 
2: 14/2 = 7 giving, (7+1)*B 
3. 7+1 = 8 giving 8*B 


4. 8*B = 24 giving 24 


ABSOLUTE AND RELOCATABLE EXPRESSIONS 


An expression is absolute if its value is unaffected by program relocation. It is relocatable if 
its value is changed by program relocation. 


Absolute Expressions 


An absolute expression may contain relocatable terms (RT) alone, or in combination with 
absolute terms (AT), provided the following conditions are met. 


Vi The relocatable terms must be paired or used in a relational 
operation. The terms in a pair must have opposite signs, but do not 
have to be contiguous, as in the example: RT+AT-RT. Each pair 
must be relocated to the same location counter. 


2. A relocatable term or. expression must not enter into a 
multiplication, division, or logical operation. For example: 
RT-RT*10 is invalid, while (RT-RT)* 10 is valid. 


3. The result of a relational operation is absolute regardless of the 
relocatability of the terms or expressions used in the operation. 


4. Relocatable terms or expressions used in a relational operation are 
considered absolute. The relocatability attribute is disregarded. Thus 
RT<LT>RT is valid even if the two terms or expressions do not 
appear in the same control section. 


ra If an expression that enters into a relational operation has multiple 
relocation attributes, an error indicator is given and the operation is 
performed as if the value of the expression were absolute, for 
example: RT<EQ>RT1+RT2. 
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Relocatable Expressions 


A relocatable expression reduces to a single relocatable value. A relocatable expression may 
contain relocatable terms alone, or in combination with absolute terms, provided the 
following conditions are met. 


1. All the relocatable terms but one must be paired, or be involved ina 
relational operation. 


2. The leftover relocatable term must not be directly preceded by a 
minus sign. 
3. No relocatable term may enter into a multiplication, division, or 


logical operation. 


Examples of Absolute and Relocatable Expressions 


The following examples illustrate absolute and relocatable expressions. A is an absolute 
term; BR1 and CR1 are relocatable terms within the current control section. XR2 is a 
relocatable term in a control section different from that in which BR1 and CR1 are defined. 
Examples of absolute and relocatable expressions are: 


Absolute Expressions Relocatable Expressions 

A-BR1+CR1 A*A+BR1+XR2-CR1 

A BR1 

BR1+A-CR1 BR1+CR1-* 

BR1+(XR2<LT>CR1)+A-CR1 (BR1<EQ>XR2)*10+CR1 
CODING FORM 


Figure 2-12 illustrates a source code form provided for convenience to the programmer and 
the keypunch operator. Since assembler statements are free form, the various fields (name, 
operation, operand, and comment) need not begin in any specified column. The only 
restrictions are that the fields appear in the sequence shown, be separated by one or more 
spaces, and the name field begin in column 1. If the name field is omitted, the operation 
field can begin in any column after column 1. 


All statements are contained in columns 1 through 72. Columns 73 through 80 are reserved 
for identification and statement sequencing. Thus, column 1 is called the begin column and 
column 72 the end column. The standard begin and end columns can, however, be altered 
by the ICTL assembler statement. (This statement is described in Chapter 6. Program 
Control Statements.) 
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NAME OPERATION OPERAND IDENTIFICATION 
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NAME FIELD 


If the name field is included, it must begin in the begin column (column 1). If the name 
field is omitted, the begin column must be blank. A name cannot be more than eight 
characters long after substitution, and cannot be continued on the next line. 


OPERATION FIELD 


The operation field begins after the first blank column. More than one blank column can 
separate the name field and the operation field; however, within the operation field, blanks 
are not allowed. The operation field after substitution cannot be more than eight characters. 
lt cannot be continued. 


OPERAND FIELD 


Operands identify or describe data used in a statement. An operand may be actual data, a 
storage address, a register number, a field length, mask, etc. A comma must separate 
operands; embedded blanks or spaces are not allowed, except in strings. 


COMMENT FIELD 


To include comments on the same line as an existing statement, the programmer must begin 
the comment at least one space after the operand field. A comment cannot extend past the 
end column (column 72). An asterisk (*) or a period and asterisk (.*) starting in the begin 
column indicate a comment statement. The asterisk is used for commentary notes on the 
source program; the period and asterisk are used for comments in a macro definition. 
Comments do not affect the assembled program, but are printed in the assembly listing. 


The following example illustrates the name, operation, operand, and comment fields. LOAD 
REGISTER on the first line is a comment because a space separates it from the last operand. 
The asterisk on the second line in column 1 specifies that all characters on that line are 


comments. 


OPERATION 


OPERAND 


12 3 4 5 6 7 B{9]10 11 1213 14 15 16 17 


19 rr 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


OAD REGISTER | ee 


IDENTIFICATION-SEQUENCE FIELD 


The identification-sequence field is used for identification or sequencing of statements. This 
optional field is normally contained in positions 73-80. The contents of the field appear in 
the source listing. The programmer may verify the statement sequence by the use of the 
ISEQ assembler statement (discussed in Chapter 6). 
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STATEMENT CONTINUATION 


A semicolon (;) indicates that a statement is continued to the next line. The first non-blank 
character in the next line is the start of the continuation line. Therefore, a blank cannot be 
the first character of a continuation line. Only one continuation line is allowed for source 
statements, except for macro instructions, prototype statements, and GBL statements. Any 
characters after a semicolon are ignored by the assembler and considered as comments. A 
semicolon preceded by an escape character retains its literal value. The first non-blank 
character of a continuation line cannot be a semicolon; nor can a continuation line be 
entirely blank. — 


The operands in the following example are two character constants: ACCOUNT; and 
TOTAL EQUALS THE FOLLOWING. The first semicolon retains its literal value because it 
is preceded by an escape character. The second semicolon indicates to the assembler that the 
second operand is continued on the next line beginning with the first non-blank character. 
HEADINGS, which appears after the semicolon, is a comment. Note that the blank between 
TOTAL and EQUALS must be coded on the first line, not in the continuation line. 


OPERAND 


NAME OPERATION 


10 11 12 13 14 15 16 17 18} 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40.41 42 43 44 45 46 47 48 49 50. 
eel CEPI PARAL cue hance 


C' ACCOUNT#;'C' TOTAL 5. HEADINGS. 
| QUALS. THE "FOLLOWING? - = 


ao oe eo A Be) qr de Saeed, Vd ee Uh fa 


ce ae ee ee 
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3. MACHINE INSTRUCTIONS 


SOURCE STATEMENTS 


Machine instruction source statements consist of: 


® Name field (optional) 

a Mnemonic operation code 
® Operand field 

e Comment field (optional) 


An example of a machine instruction source statement is given below. (The data flow of 
most machine instructions is operand 1>operand 2.) 


OPERANO 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 
Ce ee ee OS a Se ce Se Cn nT en Se ee ae Fy 


AMOUNTCRI).,R2 . THIS SETS UP R2 


INSTRUCTION ALIGNMENT AND CHECKING 

Ali machine instructions are aligned by the assembler on even-byte boundaries. The 
assembler advances the current location counter the amount necessary to ensure correct 
alignment of the assembled instructions. The contents of the area between the prealignment 
location counter and the postalignment location counter is unchanged. All expressions that 
specify storage addresses are checked to ensure appropriate alignment for the instruction 
format in which they are used. 

OPERANDS AND SUBOPERANDS 

Machine instructions have 0, 1, or 2 operands. Operands are written as a single operand, or 


as an operand with 1 or 2 suboperands. The possible formats of an operand are shown 
below. 


op 
op(subop) 
op(,subop) 


op(subop,subop) 


Operands specify immediate values, memory locations, or general register numbers, while 
suboperands specify explicit lengths or index registers. 


If indexing is not desired for an instruction, the suboperand used for indexing is omitted. 
General register zero cannot be used by machine instructions as an index. Its specification as 
an index is flagged as an error. 


The at-sign (@) in the first character position of ari operand specifies indirect addressing of a 
memory address or general register, as in the following example. 


NAME OPERATION 
12 34 5 6 7 8/9] 10 11 1213 14 15 16.17 


OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 434445 46 47 48 49 SO” 
cena ene Se eT Ol 


NAME AND LENGTH ATTRIBUTES 
Any machine instruction statement may be named by a symbol, to which other assembler 
statements can refer. The value attribute of the symbol is the address of the leftmost byte 


assigned to the assembled instruction. 


The length attribute may be 2, 4, 6, or 8, depending upon how many bytes are used for an 
instruction. 


The length field of 6 or 8 byte instruction formats can be explicit or implied. To imply a 
length, the length suboperand is omitted. The omission indicates that the length field is 
either the length attribute of the expression specifying the effective address, or the length of 
the literal. 

The length attribute of an expression is the length attribute of the Jeftmost (or only) term in 
the expression. 

NOTATION USED TO DESCRIBE MACHINE INSTRUCTIONS 


The source formats of the operands are defined using the following symbols. 


Op Code The operation codes are presented in hexadecimal (00 through FF). 


R Absolute expression specifying a general register number, 0-7. The register 
may be used as a sending or receiving field (0-7), or as an index register 
(1-7 only). 

E Absolute expression specifying an extended register, 0-15 (for RDX and 
WRX only). 

M Absolute or relocatable expression that specifies a memory address, 
0-65,535. 
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| An absolute expression specifying an immediate value; the value varies 
depending on the instruction. The value may represent an amount used in 
an arithmetic operation, a shift count, a skip count, or a bit number. 


L Absolute expression specifying a field length, usually 0-255, but longer for 
some instructions. For certain instructions the length of an operand field 
may be defined in the instruction. The length specified in the instruction 
overrides any previous field length definition, but is only in effect for that 

_ instruction. 


@ An at-sign (@) in a source operand indicates indirect addressing, an 
optional feature. For the instructions in which a register is a sending or 
receiving field, the at-sign indicates indirect addressing for Rj or R2. Ifa 
field in memory is the sending or receiving field, the at-sign indicates 
indirect addressing of Mj or M2. 


() Index registers and field lengths are optional; they are enclosed in 
parentheses in a source operand. A source operand using both an indexing 
and a field length specification would be represented like this: 
M4(L.4,R7). The comma in the parentheses must not only be coded when 
both the length and index register are used, but also if the second operand 
is used, as follows: Mj(L1) or M4(,R71). This enables the assembler to 
distinguish between the two specifications in parentheses. 


® A bullet following a mnemonic indicates the operands are 
byte-addressable; all other operands are word-addressable only. 


An R, M, |, or L in source operand 1 is identified as Rj, M1, 11, or L1; in source operand 2 
they are identified as R2, M2, 19, or La. 


The two major operand fields must be separated by a comma; no blanks are allowed 
anywhere in the operand fields. 


Remember that the at-sign and any designations in parentheses (field length and index 
registers) are almost always optional; if any of these designations are not optional, this fact 
will be noted. Data flow is usually operand 1 to operand 2, unless stated otherwise. 


SUMMARY OF MACHINE INSTRUCTIONS 


The MRX 40/50 System machine instruction set is divided into two major categories: 
General-Purpose instructions and System instructions. General-purpose instructions are the 
instructions needed to solve most data processing problems using a defined software system. 
System instructions are specialized instructions used to interpret and alter a software 
system. 
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The General-Purpose instructions may be used at any time; the System instructions require 
certain preconditions and cautions. For information on using the System instructions refer 
to the publication 7200 or 7300 Processing Unit Reference. 


Within these two major categories, the instructions are divided into functional groups, and 
these functional groups are listed in alphabetical order, as shown in the following table. 


General Purpose Instructions System Instructions 


Arithmetic Control 
Bit-Oriented 1/0 
Boolean Logic 

Branching 

Compare 

Control 

Data Conversion 

Data Transfer 

Shift 

Optional: Floating Point 


The instructions in each functional group are listed alphabetically by mnemonic. This rule 
holds for all instructions except for logical pairs or groups of instructions — these 
instructions are listed alphabetically according to the first instruction of the pair. For 
instance, PAKX (Pack) will be followed by UNPX (Unpack), and SB (Skip Back 
Unconditional) will be followed by SF (Skip Forward Unconditional). 
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GENERAL-PURPOSE INSTRUCTIONS 


Arithmetic 

Mnemonic Name Code Lath Operands 

ADD Add Memory-Register A2 4 @M1(R1),@Rg 

ADDD Add Direct B2 4 14(R7),@R5 

ADDI Add Immediate 32 2 14,@R9 

ADDK Added Packed Decimal e . 52 8 M4(Ly,R4),Mo(Lo,Ro) 
ADDM Add Memory-Memory 62 6 @M4(Ry ),@Mo(R9) 
ADDR Add Register-Register 22 2 @R1,@R5 

ADDT Add Two-Word 72 4 @M4(R4),@Ro 

DIV Divide Memory-Register AQ 4 @M4(R4),@R9 

DIVD Divide Direct B9 4 14(R4),@Ro 

DIVK Divide Packed Decimal @ 7C 8 M4(L4,R4),Mo(Lo,RQ) 
DIVI Divide Immediate 39 2 14,@R9 

DIVM Divide Memory-Memory 69 6 @M4(R4),@M5(Ro) 
DIVR Divide Register-Register 29 2 @R1,@R5 

MPY Multiply Mernory-Register A8 4 @M4(R1),@Ro 

MPYD Multiply Direct B8 4 14(R7),@Ro 

MPY|I Multiply Immediate 38 2 14,@R9 

MPYK Multiply Packed Decimal e 5B 8 M,(L4,R7),Mo(L9,R9) 
MPYM Multiply Mernory-Memory 68 6 @M 4(R7),@Mo(R9) 
MPYR Multiply Register-Register 28 2 @R1,@R5> 

SUB Subtract Memory-Register A3 4 @M4(R4),@R2 

SUBD Subtract Direct B3 4 14(R4),@Ro 

SUBI Subtract Immediate 33 2 14,@R9 

SUBK Subtract Packed Decimal e 53 8 M4(L4,R7),Mo(L9,R9) 
SUBM Subtract Mernory-Memory 63 6 @M4(R7),@M9(R9) 
SUBR Subtract Register- Register 23 2 @R1,@R9 

SUBT Subtract Two-word 73 4 @M4(R4),@Ro 

ZADK Zero and Add Decimal e 50 8 M,(L4,R7),Mo(Lo,R9) 


Bit-Oriented Instructions 


IBIT Invert Bit BF 4 @M4(R4),19 
ROFR Reverse Off-Bit 6F 2 @R1,@R9o 
RONR Reverse On-Bit 6D 2 @R1,@RQ 
SBIT Set Bit e BC 4 @M4(R4),I9 
RBIT Reset Bit @ BD 4 @M4(R4),l9 
TBIT Test Bit @ BE 4 @M4(R4),l9 
TOFR Test for Off-Bit 6E 2 @R1,@R9 
TONR Test for On-Bit 6C 2 @R1,@R9 
Boolean Logic Instructions 

AND Logical Product Memory-Register _ AS 4  — @M4(Rq),@Ro 
ANDD Logical Product Direct B5 4 14(R4),@Ro 


Boolean Logic Instructions (Continued) 


Mnemonic Name Code Lgth Operands 

ANDI Logical Product Immediate 35 2 14,@R9 

ANDM Logical Product Memory-Memory 65 6 @M4(R4),@M9(R>) 
ANDR Logical Product Register-Register 25 2 @R1,@R95 

EOR Exclusive OR Memory-Register A6 4 @M4(R1),@R9 
EORD Exclusive OR Direct B6 4 14(R7),@Ro 

EORI Exclusive OR Immediate 36 2 14,@R5 

EORM Exclusive OR Memory-Memory 66 6 @M ,(R1),@Mo(Ro) 
EORR Exclusive OR Register-Register 26 2 @R1,@Ro 

IOR Inclusive OR Memory-Register A7 4 @M4(R4),@Ro 
IORD Inclusive OR Direct B7 4 14(R4),@Ro 

IORI Inclusive OR Immediate 37 2 14,@R9 

IORM inclusive OR Memory-Memory 67 6 @M4(R1),@M5(R9) 
IORR Inclusive OR Register-Register 27 2 @R1,@R5 


Branching Instructions 


B Branch (post-indexing) ED 4 @M4(R4) 

BA1 Branch Add One E4 4 @M4(R7),@R2 
BA2 Branch Add Two E5 4 @M4(R4),@Ro 
BCF Branch on Condition Register False E9 4 @M4(R}4),I9 
BCT Branch on Condition Register True E8 4 @M4(R4),19 
BCH Branch Uncond. (pre-indexing) EC 4 @M4(R4) 

BOF Branch if Bit Off E2 4 @M4(R4),19 
BON Branch if Bit On . E3 4 @M4(R4),l5 
BR Branch to Address in Register EB 2 @R, 

BRN Branch if Register is Not Zero E1 4 @M4(R1),@R2 
BRZ Branch if Register is Zero EO 4 @M4(R4),@R5 
BS1 Branch Subtract One E6 4 @M4(R4),@R5 
BS2 Branch Subtract Two E7 4 @M4(R1),@Ro 
BSR Branch and Save Return EA 4 @M4(R7),@R5 
SB Skip Back - Uncond. BB 2 iF 

SF Skip Forward - Uncond. BA 2 ly 

SCFB Skip on Condition False - Back 4B 2 I4,19 

SCFF Skip on Condition False - Forward 49 2 Iq,19 

SCTB Skip on Condition True - Back 4A 2 Iq,19 

SCTF Skip on Condition True - Forward 48 2 Iq,19 

SRMB Skip if Reg. Minus - Back 47 2 14,R9 

SRMF Skip if Reg. Minus - Forward 46 2 14,R9 

SRPB Skip if Reg. Plus - Back 45 2 14,R9 

SRPF Skip if Reg. Plus - Forward 44 2 14,R9 

SRNB Skip if Reg. Not Zero - Back 43 2 14,R9 

SRNF Skip if Reg. Not Zero - Forward 42 2 14,R9 

SRZB Skip if Reg. Zero - Back 41 2 14,Ro 

SRZF Skip if Reg. Zero - Forward 40 2 14,R9 
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Compare Instructions 


Mnemonic 


CBY 
CBYM 
CMP 
CMPD 
CMPI 
CMPK 
CMPM 
CMPR 
CMPT 
CMPX 


Name 


Compare Byte Memory-Register @ 
Compare Byte Memory-Memory e 
Compare Memory-Register | 
Compare Direct 

Compare Immediate 

Compare Packed Decimal e 
Compare Memory-Memory 
Compare Register-Register 
Compare Two-Word 

Compare Characters e 


Control Instructions 


General Purpose Control instructions can be used at any time without preconditions; compare with System 


Control instructions. 


NOP 
RDX 
SR 


No Operation 
Read Extended Register 
Service Request 


Data Conversion Instructions 


CVB 

CVBT 
CVD 

CVDT 
EDTX 
PAKX 
UNPX 
TRNX 


Convert to Binary e 

Convert to Binary Two-Word @e 
Convert to Decimal e 

Convert to Decimal Two-Word e 
Packed Decimal/Alpha Edit e 
Pack @ 

Unpack e 

Translate e 


Data Transfer Instructions 


CLDR 
CSTR 
INV 
INVD 
INVI 
INVM 
INVR 
LOD 
LODB 
LODD 
LODI 
LODT 
MOVB 


Condition Register Load 
Condition Register Store 
Inverse Move Memory-Register 
Inverse Move Direct 

Inverse Move Immediate 
Inverse Move Memory-Memory 
Inverse Move Register-Register 
Load Memory-Register | 

Load Byte e 

Load Direct 

Load Immediate 

Load Two-Word 

Move Byte e 
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Code 


FQ 
6B 
Al 
B1 
31 
51 
61 
21 
71 
55 


EE 
FO 
13 


AA 
AA 
AB 
AB 
57 
58 
59 
56 


2B 
2A 
A4 
B4 
34 
64 
24 
AO 
F7 
BO 
30 
70 
6A 


Lgth 


OBAND DWOAN FP HH LF 


NO 


aaoanrenwrt AHA 


OPNAPRBRNHAN PF BANDN 


Operands 


@M4(R4),@R9 
@M4(R4),@Mo(Ro) 
@M4(R4),@R2 

ly (Ry ),@R9o 

14,@R9 
My(L4,R7),Mo(Lo,Ro) 
@M4(R7),@M>(R9) 
@R1,@Ro 
@M4(R7),@Ro 
M,(L4,R4),Mo(Lo,Ro) 


Blank or @M4(R4),Ro 
E7,R2 
@l, 


@M4(R4),Ro 
@M4(R4),R9 
@M4(R4),Ro 
@M4(R4),R9 

M4 (L4,R4),Mo(Lo,R9) 
M, (L4,R4),Mo(L9,R9) 
My(L4,R4),Mo(Lo,R9) 
M, (R4),Mo(Lo,R9) 


@R, 

@R, 
@M4(R7),@Ro 
14(R4),@Ro 
14,@Ro 
@M4(R4),@M(R9) 
@R,,@R> 
@M4(R1),@Ro 
@M4(R4),@Ro 
14(R4),@Ro 
14,@R9 
@M4(R7),@Ro 
@M, (R7),@M5(R9) 


Data Transfer Instructions (Continued) 


Mnemonic Name 

MOVL Move Long e 

MOVM Move Memory-Memory 
MOVR Move Register-Register 
MOVX Move Characters @ 
PSTR Program Address Store 
STO Store Memory-Register 
STOB Store Byte e 

STOT Store Two-Word 


Shift Instructions 


ARDI Arithmetic Right Double Shift - 
Immediate 
ARDR Arithmetic Right Double Shift - 
By Register 
ARSI Arithmetic Right Single Shift - 
Immediate 
ARSR Arithmetic Right Single Shift - 
By Register 
LLDI Logical Left Double Shift - Immediate 
LLDR Logical Left Double Shift - By Register 
LLS! Logical Left Single Shift - |! mmediate 
LLSR Logical Left Single Shift - By Register 
LRDI Logical Right Double Shift - Immediate 
LRDR Logical Right Double Shift - By Register 
LRSI Logical Right Single Shift - Immediate 
LRSR Logical Right Single Shift - By Register 
RLDI Rotating Left Double Shift - 
Immediate 
RLDR Rotating Left Double Shift - 
By Register 
RLSI Rotating Left Single Shift - Immediate 
RLSR Rotating Left Single Shift - By Register 
SHFK Shift Packed Decimal e 


Floating Point Instructions (Optional) 


ADDF Add Floating Point 

CMPF Compare Floating Point 

DIVF Divide Floating Point 

FLT Convert Fixed to Float 

FLTT Convert Fixed to Float Two Word 
INT Convert Float to Fixed 

INTT Convert Float to Fixed Two Word 
LODF Load Floating Point Register 

MPY F Multiply Floating Point 

NEGF Negate Floating Point Register 
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Code 


5A 
60 
20 
54 
3A 
FA 
F8 
FB 


5F 
3F 
4F 
2F 


5C 
3C 
4c 
2C 
5D 
3D 
4D 
2D 
5E 


3E 


4E 
2E 
3B 


86 
87 
89 


82 
82 
81 
81 


84 
88 
80 


Lgth 


jee) 


MON N BS NY NN NHN NY & FP PM WN O 


mo pp NNNMYN BQ DE 


Operands 


M4(L4,R4),Mo(Ro) 
@M4(R4),@M9(Ro) 
@R+,@R9 
M4(L4,R4),Mo(Lo,R9) 
@R, 

@M4(R4),@R9 
@M4(R4),@Ro 
@M4(R1),@Ro 


14,Ro 


@R4,R9 


14,R9 


@R4,Ro 


14,R9 
@R1,R9 
Iy,R9 
@R1,R9 
14,R9 
@R1,Ro 
I,Ro 
@R1,R9 
Iy,Ro 


@R1,R9 


I4,R9 
@R4,R9 
M4(Ly,R4),1g(Ro) 


@M4(R4),R 
@M 4(R4) 
@M4(R4),R9 
@R, 

@R, 
@R1.R9 
@R1,Ro 
@M4(R4),Ro 
@M4(R4),Ro 


Floating Point Instructions (Optional) (Continued) 


Mnemonic Name 
STOF Store Floating Point Register 
SUBF Subtract Floating Point 


SYSTEM INSTRUCTIONS 


Code 


8A 


85 


Lgth 


4 
4 


Operands 


@M4(R4) 
@M,(R,).Ro 


Privileged and restricted classes; consult 7200 or 7300 Processing Unit Reference manual for information 


on the use of these system instructions 


Control Instructions 


CTB Clear Tie-Breaker Register 

TST Test and Set Tie-Breaker Register 
BCM Branch to Control Memory 
RAR Read Any Register 

WAR Write Any Register 

RRO Read Register - Option Register 
WRO Write Register - Option Register 
SAR Save All Registers 

RSAR Restore All Registers 

SBA Set Busy/Active Register 

RBA Reset Busy/Active Register 
SCN Set Control Register 

RCN Reset Control Register 

SPM Set Privileged Mode Register 
RPM Reset Privileged Mode Register 
WRX Write Extended Register 


1/O Instructions 


DIO Disc Input/Output 

INP | Input from t/O Register 

OUT Output to 1/O Register 

RDC Communications Input/Output 
WRC Communications Output 

slo System Input/Output 


Lgth 


UN NNNNN SERED ENN | 


NO NON NY N ND 


Operands 


Ry,l9 

14(R4),@R9 

14(R4),@Ro 

14(R4),@Ro 

14(R4),@Ro 

M4(R4),I9 or M4(R4),@R9 
M4(R4),I9 or M4(R4),@R9 
14,12 or @Rq,19 

14,15 or @R1,l9 

14,19 or @Ry,19 

I4,19 or @R4,19 

14,19 or @Ry,19 

14,12 or @Rq,19 

E1,Ro 


@R41,R9 
14,@Ro 
14,@R9o 


Ry,Ro 
@R1,Ro 


SUMMARY OF EXTENDED MNEMONICS 


The assembler provides extended mnemonic codes which allow unconditional skips, and 
conditional skips and branches to be written in a symbolic form that is easier to use than 
standard machine instructions. The assembler translates the extended mnemonic codes into 
machine instruction object code. 


Extended mnemonic codes for skip instructions do not specify the forward (F) or backward 
(B) direction of the skip. Thus, the extended mnemonic, S, can be used instead of the SF or 
SB machine instruction. The assembler determines the direction of the skip for the S 
instruction from the memory address or immediate value in the operand. For example, S 
DOG skips to the address, DOG, whether DOG is before or after the present location 
counter. 


Extended mnemonic codes for branch and skip instructions that test the condition register 
specify the condition in the mnemonic itself rather than in the operand for example. SOV 
ADDRS skips to ADDRS if overflow has occurred. The standard machine instruction names 
the direction and the bit status in the mnemonic, and the actual bit number tested in the 
operand. Thus, the extended mnemonic SOV 4 is the same as the standard instruction SCTF 
4,0. (Bit 0 of the condition register is the overflow bit.) 


The extended mnemonic codes are grouped as follows: 


e Address Coded Skips 

® After Arithmetic Instructions 

e After Compare Instructions — Arithmetic Test 
] After Compare Instructions — Logical Test 

e After Decimal Instructions 

® After PAKX Instruction 

@ After TBIT Instruction 

@ Conditional Register Test 


Just as for the standard instructions, indirect addressing and indexing are optional for the 
extended mnemonic codes. 
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EXTENDED MNEMONIC CODES 


Address-Coded Skips 


Extended Code Machine Instruction Meaning 
$s My, or |, SF 14 Skip forward or backward 
~ $B ly 

SRZ My,R9 or 14,R9 SRZF 14,R9 Skip if reg. is zero, forward or 
SRZB_14,R9 backward 

SRN My,Ro or 14,R9 SRNF  14,R9 Skip if reg. is non-zero forward or 
SRNB backward 

SRP My,R9 or 14,R9 SRPF  14,R9 Skip if reg. is plus, forward or 
SRPB- 14,R9 backward 

SRM M4,R9 or 14,R9 SRMF 14,R9 Skip if reg. is minus, forward or 
SRMB_ 14,R9 backward 


For S, the 1; value = -255 through +255; for all other extended mnemonics in this category, |4 = -15 
through +15. 


For SF and SB, the 1, value = 0-255; for all other regular instructions in this category 14 = 0-15. 


After Arithmetic Instructions 


BOV @M4(R4) BCT @M4(R4),0 Branch if overflow 
BNV @M4(R4) _ BCF @M,(R4),0 Branch if no overflow 
BCY  @M,(R,) BCT  @M,(R4),3 Branch if carry 
BNC @M4(R4) BCF @M4(R4),3 Branch if no carry 
SOV M, or |, SCTF 14,0 Skip if overflow 
SCTB 14,0 
SNV My or ly SCFF 14,0 Skip if no overfiow 
SCFB 14,0 
SCY My, or |, SCTF 14,3 Skip if carry 
SCTB 14,3 
SNC My or |y SCFF 14,3 Skip if no carry 
SCFB 14,3 


1, =-15 through +15 for the extended instructions. 14 = 0-15 for the regular instructions. 


After Compare Instructions — Arithmetic Test 


The arithmetic test tests the result of a signed arithmetic compare between operand 1 and operand 2. In 
the following table, 1 and 2 under Meaning refer to the signed values of operands 1 and 2. 


Extended Code Machine Instruction Meaning 

BGT @M4(R4) BCT @M4(R4),1 Branch if 1 GT 2 
BLT @M4(R4) BCT @M4(R4),2 Branch if 1 LT 2 
BGE @M 4(R4) BCF @M4(R4),2 Branch if 1 GE 2 
BLE @M (Ry) BCF @M4(R}4),1 Branch if 1 LE 2 
BEQ @M4(R4) BCT @M4(R4),3 Branch if 1 EQ 2 
BNE @M4(R4) BCF @M4(R4),3 Branch if 1 NE 2 
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After Compare Instructions — Arithmetic Test (Continued) 


Extended Code Machine Instruction Meaning 

SGT My or ty SCTF 14,1 Skip if 1 GT 2 
SCTB 14,1 

SLT My or 14 SCTF 14,2 Skip if 1 LT 2 
SCTB 14,2 

SGE My, or |, SCFF 14,2 Skip if 1 GE 2 
SCFB 14,2 

SLE M, or |y SCFF 14,1 Skip if 1 LE 2 
SCFB 14,1 

SEQ My or 14 SCTF 14,3 Skip if 1 EQ 2 
SCTB 14,3 

SNE My, or ly SCFF 14,3 Skip if 1 NE 2 
SCFB 14,3 


1, =-15 through +15 for extended instructions. 14 = 0-15 for regular instructions. 


After Compare Instructions — Logical Test 


The logical test tests the results of an unsigned arithmetic (logical) compare between operand 1 and operand 
2. In the following table, 1 and 2 uncer Meaning refer to the unsigned values of operands 1 and 2. CMPX 
and all variations of the CBY instruction always yield a logical result. 


Extended Code Machine Instruction Meaning 

BLGT @M,(R}4) BCT @M4(R4),5 Branch if 1 GT 2 

BLLT @M,(R},) BCT @M4(R4),6 Branch if 1 LT 2 

BLGE @M,(R}4) BCF @M4(R4),6 Branch if 1 GE 2 

BLLE @M,(R}) BCF @M4(R4),5 Branch if 1 LE 2 

BLEQ @M,(R}) BCT @M4(R4),7 Branch if 1 EQ 2 

BLNE @M,(R;) BCF @M4(R4),7 Branch if 1 NE 2 

SLGT Mj orl, SCTF 14,5 Skip if 1 GT 2 
SCTB 14,5 

SLLT Mj orl, SCTF 14,6 Skipif 71 LT 2 
SCTB 14,6 

SLGE Mj, orl, SCFF 14,6 Skip if1 GE 2 
SCFB 14,6 

SLLE My orl, SCFF 14,5 Skipif 1 LE 2 
SCFB 14,5 

SLEQ Mj orl, SCTF 14,7 Skip if 1 EQ 2 
SCTB 14,7 

SLNE My or ly SCFF 14,7 Skip if 1 NE 2 
SCFB 14,7 


14 =-15 through +15 for the extended instructions. !4 = 0-15 for the regular instructions. 


After Decimal Instructions 


BKP @M (Rj) BCT @M4(R4),1 Branch if plus 
BKM @M,(R,) BCT @M,4(R4),2 Branch if minus 
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After Decimal Instructions (Continued) 


Extended Code 


BKZ @M,(R,) 
SKP M, or 14 


SKM M, or |4 


SKZ My orl, 


Machine Instruction 


BCT  @M,(Rj),3 


SCTF 14,1 
SCTB 141 
SCTF 1,2 
SCTB 14,2 
SCTF 14,3 
SCTB 14,3 


Meaning 


Branch if zero 
Skip is plus 


Skip if minus 


Skip if zero 


14 = -15 through +15 for the extended instructions. 1, = 0-15 for the regular instructions. 


After PAKX Instruction 


BID @M4(R4) 
BNI @M4(R4) 
SID My, or |y 


SNI My or ly 


BCT @M, (Ry ),4 
BCF @M4(R4),4 


SCTF 14,4 
SCTB 14,4 
SCFF 14,4 
SCFB 14,4 


Branch if invalid digit 
Branch if no invalid digit 
Skip if invalid digit 


Skip if no invalid digit 


1, =-15 through +15 for the extended instructions. 1, = 0-15 for the regular instructions. 


After TBIT Instruction 


BBS  @M,(R4) 
BBR @M,(R4) 
SBS M, or 14 


SBR M, or ly 


BCT  @M4(Rj),0 
BCF  @M,(R,),0 


SCTF 14,0 
SCTB 14,0 
SCFF 14,0 
SCFB 14,0 


Branch if bit.is set 
Branch if bit is reset 
Skip if bit is set 


Skip if bit is reset 


14 = -15 through +15 for the extended instructions. |, = 0-15 for the regular instructions. 


Condition Register Test 


SCF My,l9 or I4,I9 


SCT My,I9 or 14,19 


Iq = -15 through +15 and I9 = 0-15 for the extended instructions. 14 and Ip = 0-15 for the regular 


instructions. 


SCFF 14, 
SCFB 14, 
SCTF 14,1 
SCTB  14,I 
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Skip if bit spec. by I> is off 


Skip if bit spec. by !9 is on 


_ 4, ASSEMBLER INSTRUCTION SOURCE 
STATEMENTS — OVERVIEW 


Assembler statements are requests to the assembler to perform certain operations during the 
assembly. Some statements, such as WDD and BDD, generate data, while others, such as 
EQU and SPACE, are effective only at assembly time. A summary of assembler statements 
can be found in Appendix E. 


Assembler instruction source statements consist of: 


@ Name field (usually optional) 

e 7 Mnemonic operation code 

e Operand field (optional for some statements) 
e Comment field (optional) 


An example of an assembler instruction source statement is: 


NAME i OPERATION OPERAND 
“12.3.4 8 6 7. 8{9[ 10 11 12 13 14 15 16 17} 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43.44 45 46 47 48 49 50 
NAMEI | 1C.12,6).. GENERATE 6@ ZEROS...... 


bi Bs Ran ee Scomart CRO | oo i s Was ee Fewer) Sa! SPREE SPO o] SERaEY Peers Wee! & at 


The following is a list of assembler statements with a short explanation for each statement. 
Program Sectioning and Linking Statements 
- CSECT Identifies the beginning or continuation of a control section 


ENTRY Identifies relocatable symbols defined in the current program that are 
used in another program 


EXTRN_ Identifies relocatable symbols used in the current program that are 
defined in another program 


COM Identifies the beginning or continuation of a common control section 
Program Control Statements | 

ORG Sets the location counter 

END Ends the assembly 


PUNCH Writes data in a user-defined file 


4.1 


LTORG Assembles literals in a pool 

ICTL Specifies nonstandard input format 

ISEQ Checks the lines of code for the correct sequence 

ALIGN Sets the current location counter to a storage boundary 
Linkage Editor Map Address Directive Statement 

SEG Defines load-module segment 
Symbol and Data Definition Statements 

EQU Defines a symbol and assigns values and attributes to it 

WDD Defines word aligned data (in bytes) 

BDD Defines byte aligned data (in bytes) 

WRS Reserves word aligned storage (in words) 

BRS Reserves byte aligned storage (in bytes) 

FORM _ Defines bit-oriented formats (in aoe bytes) 
Listing Control Statements 

TITLE Identifies the listing 

EJECT Starts a new page 

SPACE _ Inserts blank lines 

PRINT Specifies the details to be printed 
Macro Definition Statements 

MACRO Begin macro definition 

MEXIT Conditional exit from macro definition 

MEND — End macro definition 


MNOTE Macro message 
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Conditional Assembly Statements 


SETA 
SETC 
GBLA 
GBLC 
ADO 
AGO 


ANOP 


Assigns arithmetic values to set symbols 
Assigns character values to set symbols 
Defines a SETA symbol as global 

Defines a SETC symbol as global 

Sets up a source statement generation loop 
Specifies a branch to another statement 


Specifies an assembly no-operation statement 
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5. PROGRAM SECTIONING AND LINKING STATEMENTS 


The programmer can divide a lengthy or complex program into control sections to make it 
more manageable and easier to debug. Each section is assigned a unique name. The operating 
system treats each section as an independent, relocatable routine that can be executed alone 
or linked with others. 

During assembly, the assembler creates an index of all assigned control section names. At 
load time, the Linkage Editor uses the index to link the various control sections into a single 
storage module, from which the connected sections can be executed as a complete program. 


The assembler mnemonics and functions of the program sectioning and linking statements 
are: 


CSECT Identifies the beginning or continuation of a control section. 


ENTRY Identifies relocatable symbols defined in the current program that are used 
in another program. 


EXTRN Identifies relocatable symbols used in the current program that are defined 
in another program. 


COM Identifies the beginning or continuation of a common control section. 


(The reserved symbolic segment tag, $SYSEG, is also explained in this section.) 


CSECT — IDENTIFY CONTROL SECTION 


The CSECT statement identifies the beginning or continuation of a control section. The 
format of the CSECT statement is: 


Operation | Operand 


Symbol or CSECT Not used — ignored by the 
blank assembler 


lf a symbol appears in the name field, it is the name of the control section; otherwise, an 
unnamed control section is defined. The symbol in the name field represents the address of 
the first byte of the control section. It has a length attribute of 1. 


To preclude the generation of an unnamed CSECT section; the CSECT statement must 
precede all statements except the following: macro and FORM definitions, listing control 
statements, conditional assembly statements, I|CTL and ISEQ statements, EXTRN and 
ENTRY statements, PUNCH statements, and comments. 
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if the assembler encounters a statement other than these before a CSECT statement, an . 
unnamed CSECT statement is generated. 


All statements following the CSECT statement are assembled as part of that control section 
until another CSECT or COM statement is encountered. A control section can be 
interrupted and then resumed by inserting another CSECT statement with the same name, 
as in the following example. Control section ONE includes all code between the first ONE 
CSECT card and the TWO CSECT card plus all code following the second ONE CSECT card. 
Unnamed control sections can also be resumed. 


ONE CSECT 

Control section ONE 
TWO CSECT 

| Control section TWO 
ONE CSECT 


Control section ONE 


SYMBOLIC LINKAGE STATEMENTS — ENTRY AND EXTRN 


The symbolic linkage statements, ENTRY and EXTRN, allow a symbol to be defined in one 
program and referred to in another program. The program defining the symbol uses the 
ENTRY statement; the program referencing the symbol uses the EXTRN statement. In both 
instances, the assembler provides the linkage editor with the information to resolve the 
symbolic linkage. 


ENTRY — IDENTIFY ENTRY POINT SYMBOL 


The ENTRY statement specifies which relocatable symbols defined in the current program 
can be accessed by other programs. The format of the ENTRY statement is: 


Operation Operand 


Sequence One or more relocatable 
symbol symbols separated by comma 
or blank 


The symbols in the operand field may be used as operands by other programs. Control 
sections named in CSECT or COM statements are automatically considered entry points and 
do not have to be listed in an ENTRY statement. In the following example, the ENTRY 
statement identifies SUB1 and SUB2 as entry points to the program: 


5-2 


OPERATION OPERAND 


a Bee ds otal pe as aes Seen Rat cerd at a ee 


eee Sep ee ee Beck 4 . 1 . ~ . os : ee rs ce. ox 1 


EXTRN — IDENTIFY EXTERNAL SYMBOL 


The EXTRN statement identifies relocatable symbols that can be used in the current 
program, although they are defined elsewhere. The format of the EXTRN statement is: 


Operation Operand 
Sequence One or more relocatable 


symbol symbols separated by commas | 
or blank 


Symbols named in the operand field cannot appear in an ENTRY statement in the same 
program. The combined total of control section and external symbols in the same program 
cannot exceed 252. 


_The example in Figure 5-1 shows how two programs, PROGA and PROGB, use EXTRN and 

ENTRY, so PROGA can use symbols defined in PROGB. EXTRN in PROGA identifies 
FETCH as a symbolic address that is defined in another program. ENTRY in PROGB 
defines FETCH as an entry point in PROGB. Thus PROGA can use FETCH as an operand 
without first defining it. 


NAME — fi OPERATION 


12 34 5 67? g}9] io 1 12 13 14 15 16 17} 18] 19. 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


PROGA ..| CSECT .. ||... 
eenemereneees |. 6, ramet b 


OPERAND 


Be 58 aiken he eae ery Apres nemo” encener’ Omeaee Mr seS Sener Siem Ree. are cee 
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Figure 5-1. Example of EXTRN and ENTRY 
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COM — DEFINE COMMON CONTROL SECTION 


The COM statement identifies the beginning or continuation of a common control section. 
The format of the COM statement is: 


Operation Operand 


Symbol! Not used — ignored by 
or blank the assembler 


If a symbol appears in the name field, it is the name of the common storage area; otherwise, 
an unnamed common storage area is defined. An unnamed COM control section does not 
have the same name as an unnamed CSECT section. If two COM statements with the same 
name appear in the same program, the second is a continuation of the first. When COM 
statements are assembled, the common location assignment starts at zero. The symbol in the 
name field represents the address of the first byte of the control section. It has a length 
attribute of 1. 


Since a COM control section's primary function is to define the structure of a storage area 
used by more than one program, no binary data can be generated by statements within the 
COM section. However, pertinent storage information such as address assignment, 
relocatability, and length attributes are retained and assembled in the normal way, without 
binary output. 


Data can be stored in a common storage area during assembly only by a CSECT control 
section in a different assembly, in which case the CSECT control section must use the same 
name as the common area defined and reserved by COM statements. After the programs are 
assembled and the Linkage Editor has performed the necessary linkage, data can be 
retrieved, stored, checked, and manipulated in the common area by any cognizant program 
currently being executed. 


No more than one CSECT control section may be included in a set of COM control sections 
identified by the same name in the same load module. 


The example in Figure 5-2 shows how two programs communicate information through the 
common area. Each program must know the other’s plan for structuring and using the 
common storage area. If program PROGA is to pass information to PROGB, PROGB must 
know the location in COMMON to which PROGA will pass the data. In this example, 
information is passed through COMMON at location TAGE. In PROGA, the statement STO 
TAG5,R2 stores the contents of register 2 at location TAG5. After the branch is made to 
FETCH, PROGB loads the contents from TAGE (which is the same location as TAGS in 
PROGA) into its register and checks to see if it is equal to the hexadecimal constant: ‘AF’. 
If a true comparison is found, a branch is made to PROGC. Note that when the Linkage 
Editor is called to link the programs at load time, each program is linked to COMMON. 
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Figure 5-2. Example of the COM Statement 
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RESERVED SYMBOLIC SEGMENT NAME — $SYSEG 


The reserved symbolic segment name, $SYSEG, is a relocatable segment designator which 
makes extended addressing possible. A reserved name has a special meaning to the system 
and should not be used as a symbol for any purpose other than its special meaning. 


Symbolic segment tags are used for address referencing across program (or storage) 
segments. However, a user whose program is limited to one segment need not use segment 
tags. To make all system interfaces (I/O requests and service requests) compatible, addresses 
specified in these interfaces must have an associated segment tag. 


When.a single-segment program is written, the assembler assigns the global system name, 
$SYSEG, to the first (and only) segment in the program. $SYSEG is automatically entered 
in the symbol table by the assembler, and thus becomes a reserved identifier. 


The name $SYSEG is used as a default value in all system macros containing address 
parameters. The user must concern himself with $SYSEG only if he is coding system 
interfaces directly without using the regular system macros. 


$SYSEG cannot be used in a multi-term expression. It can only be used as an operand ina 
BDD, WDD, or FORM instruction. If it is used in a FORM instruction, the size of the 
corresponding definition field must be 8 bits in length and start on a byte boundary. The 
length attribute of $SYSEG is 1. 


6. PROGRAM CONTROL STATEMENTS 


The assembler mnemonics and functions of the program control statements are: 
ORG Sets the location counter 
END Ends the assembly 
PUNCH Writes data in a user-defined sequential disk file. 


LTORG Inserts the accumulated literal pool, starting at the current location 
counter. . 


ICTL Specifies nonstandard input format. 
ISEQ Checks the lines of code for the correct sequence. 


ALIGN _ Sets the current location counter to a storage boundary address. 


ORG — SET LOCATION COUNTER 


The ORG statement alters the setting of the location counter. The format of the ORG 
statement is: 


Operation Operand 


Sequence Relocatable expression or 


symbol blank 
or blank 


Symbols in the expression must be previously defined. The unpaired relocatable symbol 
must be defined in the same control section in which the ORG statement appears. The 
location counter is set to the value of the expression in the operand, or to its previous high 
count, if the operand field is blank. 


Since the location counter points to a storage location that is to receive the next line of 
assembled code, altering its setting permits a programmer to return to a previous location in 
his program and change its contents. In this way, an area can be redefined during assembly, 
changing data definitions to meet various requirements in the program. 


An example of an ORG statement is: 


OPERAND 


OPERATION 


NAME 


1.2 3.4 5 6 7 8/9] 10 11 12 13 14 16 16 17[18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 36 36 37 38.39 40.41 42 43.44 45 46 47 48 49 50 
te th he nthe ep hed nhemvnndarererh wrens 
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If the location named TAG is twelve bytes from the beginning of the control section, this 
statement sets the location counter to OOOC. Statements that follow the ORG statement are 
then assembled beginning at address OOOC. The information previously assembled at these 
locations is lost, although the name tags remain unchanged and cannot be duplicated. 


The ORG statement can also be used in direct reference to the location counter. The format 
of the operand is *-n or *+n. The asterisk specifies the present location counter, and n 
specifies the number of bytes. The following statement decreases the present location 
counter by 60: 


NAME OPERATION OPERAND 


12 3 4 § 6 7 819] 10 11 1213 14 15 16 17/18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38.39 40 41 42 43 44 45 46 47 48 49 50 
Cee ee ne ee es a es ne ee eT ene S a eT eS eS nT ne OF 


An ORG statement without an operand returns the location counter to its previous high 
count, as in the following statement. If the counter has already reached its previous high, an 
ORG without an operand has no effect. 


NAME OPERATION OPERAND 


12345 67 8 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 


10111213: 14 15.16 17 


The following example shows an ORG with a location counter reference and an ORG 
without an operand. If the location counter is 0050 when ORG *-20 is encountered, the 
count is decreased by 20 bytes to O003C. Then if the ORG without an operand is 
encountered before the counter reaches its previous high of 0050, the count is returned to 
0050. 


OPERAND 


19 20 21 22 23 24 26 26 27 28 29 39 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 
re ee ee Cn eT Ce Ce ON Cn eS ee Oe ee ee 


For an example of an application of the ORG statement, refer to Figure 8-3 in Chapter 8. 
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END — END ASSEMBLY 


The END statement terminates the assembly of a program. The format of the END 
statement is: 


Operation Operand 
END Ordinary symbol or blank 


An ordinary symbol in the operand field specifies the point to which control is to be 
- transferred when loading is complete. The ordinary symbol must identify a symbolic address 
in the current assembly. Substitution is invalid on the END statement. Continuation is 
ignored on the END statement. . 


PUNCH — WRITE TO FILE 


The PUNCH statement writes data in a user-defined sequential disk file. The format of the 
PUNCH statement is: 


Operation Operand 


Sequence Not used 
symbol 


or blank 
The PUNCH statement precedes the line of code that is to be written in the file. The line of 


code can be in any format and it cannot be continued. In the following example, //DEF 
ID=I|NPUT,FIL=CAT is written in a file defined by the user: 


NAME l OPERATION 
12.34 5 6 7 819] 10 11 1213 14 15 16 17 
PUNCH 1 


OPERAND 


19 20 21 22 23 24 25 26 27.28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 


Variable symbols in the line of code are resolved before the record is written to the file. If 
substitution results in a record that exceeds the standard statement size (columns 1 through 
72) or nonstandard size specified by an ICTL statement, excess characters are truncated on 
the right. . 


The PUNCH statement does not lend itself to a fixed field format, because as values of 
various lengths are substituted for a variable symbol, the position of the subsequent fields is 
shifted. 


In the following example, values are substituted for the variable symbols $TAG and $VAL 
before the record is written. 
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NAME OPERATION OPERAND 
12 3.4 5 6 7 819] 10 11 1213 14 15 16 17} 181 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 4041 42 43.44 45 46 47 48 49 50 
UN: L a 4. 


tee Mh ao VE 


If $TAG is equal to AB and $VAL is equal to 75, the record written in the file is: NAME IS 
AB VALUE IS 75. 


If STAG is equal to C‘THIS IS A MESSAGE’ and $VAL is equal to 10, the record written in 
the file is: NAME IS C’THIS IS A MESSAGE’ VALUE IS 10. 


Notice that the statement VALUE IS. ..is moved to the right to make room for the first 
statement NAME IS... . 


A fixed field format may be established by using a variable symbol with as many characters 
(including the ampersand) as the substituted value. 


LTORG — BEGIN LITERAL POOL 


The LTORG statement assembles previously defined literals into a single area called a literal 
pool. All preceding literals, back to the beginning of the program, or back to the last 
LTORG statement, are assembled at the next word boundary. If a LTORG statement is not . 
used, all literals are assembled after the first control section. Literals that appear after the 
last LTORG statement are also assembled after the first control section. 


The format of the LTORG statement is: 
Symbol 
or blank 


A symbol in the name field represents the address of the first byte of the literal pool. The 
length attribute of the symbol is 1. 


Operation Operand 


Not used 


ICTL — INPUT FORMAT CONTROL 


The ICTL statement specifies that statements in a program begin and end in columns other 
than the standard columns 1 and 72. The format of the ICTL statement is: 


| Name Operation Operand 


Not used Two decimal arithmetic 
constants separated by 
acomima 


Both decimal constants are required. The first constant specifies the beginning column 
(1-40). The second specifies the end column (41-120). A comma must separate the two 
constants. 


If the source program does not contain an ICTL statement, the standard format (columns 1 
and 72) is used. Because system macros are always processed in the standard format, they 
are not affected by the ICTL statement. 


Since the ICTL statement establishes a new format, it must be the first statement in the 
program and can be used only once. The ICTL statement cannot be continued. 


The following statement establishes column 10 as the begin column and column 90 as the 
end column. 


NAME 
12345678 


OPERATION OPERAND 


10 11 12 13 14 15 16 17} 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
a oe err rane i a treet tht earner nnaehematnseeenac, 
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ISEQ — INPUT SEQUENCE CHECKING 


The ISEQ statement specifies that all subsequent statements are to be checked or not 
checked for correct sequence. The format of the ISEQ statement is: 


Name Operand 


Operation 


Blank 


Blank, or two decimal arithmetic 
constants, separated by a comma 


If the operand field is used, both decimal constants must be specified. The first constant 
specifies the column number of the leftmost character of the sequence field; the second 
constant specifies the column number of the rightmost character of the sequence field. A 
comma must separate the two operands. 


Sequence checking begins with the first line following the ISEQ statement and continues up 
to an ISEQ statement without an operand. Checking can be resumed with another ISEQ 
statement. If each succeeding sequence field is not higher in value than that of the preceding 
statement, a sequence error message is generated. A sequence error does not terminate the 
assembly. 


The columns identified by the ISEQ statement must be between columns 73-80 if the 
standard begin and end columns are used, or outside the begin and end columns defined by 
an ICTL statement. 


Sequence checking is only performed on statements contained in the source program. Macro 
definitions in a macro library or lines generated by a macro instruction are not checked. 
Lines with a blank sequence field are always considered to be in the correct order. 


The operand field of an ISEOQ statement may not contain a reference to a variable symbol. 
The ISEQ statement cannot be continued. 


ALIGN — ALIGN LOCATION COUNTER 


The ALIGN statement sets the value of the location counter to an address determined by a 
value in the operand field; the assembler updates the counter to the next highest address 
which is a multiple of the expressed value in the operand. The format of the ALIGN 
statement is: 


Operation Operand 


Absolute 
arithmetic expression 


Symbol 
or blank 


The operand can be an expression to be evaluated by the assembler; however, all symbols 
must be previously defined. 


In the following example, the location counter is set to the next highest multiple of 4 
addresses. If the location counter is at 1009 when the statement is encountered, it is set to 
100C. However, if the location counter is already set to an address which is a multiple of the 
operand value (1008, 100C, 1010, etc.), the counter is not changed. After alignment, the 
address of the location counter is assigned the symbolic name in the name field. In the 
example, FOUR is equal to 100C. The length attribute is always 1. 


OPERATION 


NAME OPERAND 


0 31 32 33 34 35 36 37 38.39 40 41 42 43 44 45 46 47 48 49 50. 


a lh rh 


12.3.4 5 6 7 B19] 10 11 1213 14 15 16 17] 18] 19 20 21 22 23 24 25 26 27 28 29 3 


ALIGN . 


If the counter is set to an address exceeding 65,53510, an error message is generated and 
alignment occurs. The location counter is set to the value exceeding 65,53510. An address 
of 65,60049 will set the location counter to 6410. . 


6-6 


7. LINKAGE-EDITOR MAP DIRECTIVE — SEG 


The Linkage Editor map directive, SEG, may be used as an assembly language statement. 
The assembler does not process the statement, but simply writes the directives, in their 
source form, on the output file. 


All SEG statements in an assembly must immediately precede the END statement. The only 
statements that can appear between the SEG statement and the END statement are the 
conditional assembly statements SETA, SETC, ADO, AGO, ANOP, and macro instructions 
generating these statements. A SEG statement cannot be continued and no substitution is 
performed. 

The function and format of the SEG statement is described in the publication MRX/OS 
Program Library Services Reference. 


8. SYMBOL AND DATA DEFINITION STATEMENTS 


The assembler mnemonics and functions of the symbol and data definition statements are: 
EQU Defines a symbol and assigns values and attributes to it. 
WDD Defines word-aligned data (in bytes). 
BDD Defines byte-aligned data (in bytes). 
WRS Reserves word-aligned storage (in words). 
BRS Reserves byte-aligned storage (in bytes). 


FORM Defines bit-oriented data formats (in storage bytes). 


EQU — EQUATE 


The EQU statement assigns values and attributes to a symbol. The format of the EQU 
statement is: 


Operation Operand 


Ordinary Expression 
or variable 


symbol 


The expression in the operand field can be absolute or relocatable; however, all symbols in 
the expression must be previously defined. 


The symbol in the name field is given the same length, value, and relocatability attributes as 
the expression in the operand field. The length attribute of the symbol is that of the 
leftmost (or only) term of the expression. When that term is a location counter reference (*) 
or an arithmetic constant, the length attribute is 1. The value attribute of the symbol is the 
value of the expression. When the newly defined symbol is referenced in later statements, it 
has all the attributes assigned by the EQU statement. 


The EQU statement can equate symbols to register numbers, immediate data or other 
arbitrary values, as shown in the first two examples of Figure 8-1. 


The EQU statement can also equate symbols to frequently used or complex expressions, so 
that the programmer can use the symbol rather than an entire expression, as shown in the 
last two examples of Figure 8-1. Note that all symbols in the expression must be previously 
defined. 
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NAME OPERATION OPERAND 
12 3 4 6 6 7 8(9] 10 11 1213 14 15 16 17]18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40.41 42 43.44 45 46 47 48 49 50 
. 
ER MUN ; 


wood +2516 . 
(€84B)/ 7H) #85-NAR ie eer ean 


Figure 8-1. Examples of EQU Statements 


WDD AND BDD — WORD AND BYTE DEFINED DATA 


The WDD and BDD statements define aligned data in storage. The WDD statement aligns the 
data constant defined in the operand at word boundaries; the BDD statement aligns data at 
byte boundaries. Both statements have the same basic format: 


Operation Operand 


Any symbol WDD or BDD One or more operands 
or blank separated by commas 


The name field reflects the address after alignment. 
Operands must be separated by commas and have the format: 


a Where: 


om 
hon 
?) 
2 
Il 


A data value to be generated (required); any valid ex- 
pression. If the data value is a forward symbolic refer- 
a(b) ence, and no explicit size is coded, it is assumed to be 
a two-byte value. 


b = A length specification (in bytes); a positive predefined 
absolute expression. If omitted, the length specification 
is the implied size of the expression. If the explicit size 
of a forward symbolic reference is one byte, and if the 
symbol resolves to an arithmetic or string of more than 
one byte, a warning diagnostic is issued. 


c = A repetition factor; a positive predefined absolute ex- 
pression. If omitted, a repetition of one is assumed. 
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Locations Contents 


OOFC XX XX xx indicates that the contents are 
OOFE 00 O00 residual data 

0100 00 OO 

0102 00 OO 

010C 00 OO 


TAG, then is equal to OOFE. However, if TAG BDD 0(4,2), 0(4,2) is specified rather than 
TAG WDD 0(4,2),0(4,2) and the location counter points to OOFD, the first zero byte is 
stored at address OOFD and the last byte at address 010C. TAG is equal to OOFD. 

} 


If multiple operands are specified, each operand is word-aligned for the WDD statement, or 
byte-aligned for the BDD statement, as in the example: 


Statement Generated Data 


WDD TAG1,X‘13',X‘05’, TAG2 TAG1 Word 1 
13 xx Word 2 
05 xx Word3 
TAG2 Word 4 


Where: 
TAG1 = atwo-byte relocatable tag 
XX = contents are residual data 
TAG2 = atwo-byte relocatable tag 


WRS AND BRS — WORD AND BYTE RESERVE STORAGE 


The WRS and BRS statements reserve storage without preset data. The format of the WRS 
and BRS statement is: 


Name Operation Operand 


Absolute 
arithmetic expression 


Any symbol WRS or BRS 
or blank 


The symbol in the name field is the address of the first byte, and has the length attribute 
(number of bytes) of the storage area. 
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The operand of the WRS statement specifies the number of words to reserve; the operand of 
the BRS statement specifies the number of bytes. Symbols used in the operand field must 
be previously defined, and when evaluated must equal a positive, absolute arithmetic value. 
If the operand is zero, the location counter is aligned on the specified word or byte 
boundary. 


In the following example, WRS and BRS each reserve 800 bytes of storage. The first byte of 
the WBUFF area begins on a word boundary, while no distinction between odd or even 
address bytes is made for BBUFF. 


OPERATION OPERAND 


123 4 5 6 7, 8{39| 10 11 1213 14 15 16 17|18| 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 36 36 37 38.39 40.41 42 43.44 45 46 47 48 49 50, 
» 


In Figure 8-3 the example shows the use of an ORG statement in conjunction with WDD 
and BRS. After the second ORG statement, the value of TAG1(29,1) is: CONTENTS OF 
ABCD ARE INVALID. 


NAME OPERATION OPERAND 


10 24 12 13 4 15 16 17 18 19 20 “21 22 23 24 25 26 27 28 29 20 31 31 32 33 34 35 36 37 38 39° 40 ay 42 43 44 45 46 47 48 49 50. 
rrr reenter tne tin eet enememedirneientewnahennnsn pm nen wnt en, 


(2 34.66 28 


WDD .. | IC CONTENTS OFT eit ada cag See 
DD. | C'ARE INVALED. artis acl bon sha itia ah eabees 
‘Niore "RETURNS CTR To TAG2 |. 
—SIWDD. tc KBD. INSERTS. CHAR’S. AT TAG2 . 
ORG... eTR SET To PREN, Tous HIGH 
END . ||... ee ares nae 


Figure 8-3. Example of an ORG Statement with WDD and BRS 
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FORM — DEFINE DATA FORMAT 


The FORM definition statement defines a symbolic name to be used as a mnemonic in the 
operation field of a subsequent statement, and specifies the size (in bits) and storage 
alignment of each operand to be used with the mnemonic. The format of the FORM 
definition statement is: 


Operation | Operand 


Ordinary One or more positive arithmetic 
symbol expressions separated by commas 


The name field which is required, defines the mnemonic operation code for a FORM 
instruction statement. Expressions in the operand field must equal a number between 1 and 
255. Symbols in the operand field must be previously defined. 


The FORM definition statement in the following example defines a mnemonic, STAR, and 


specifies that its first operand is assigned four bit positions; the second, four also; and the 
third, eight bit positions. 


OPERAND 


FORM — INSTRUCTION STATEMENT 
The FORM instruction statement specifies the data to be generated according to the format 


defined by the corresponding FORM definition statement. The format of the FORM 
instruction statement is: 


Operation Operand 


Any symbol FORM name 
or blank 


The FORM name in the operation field must be previously defined in a FORM definition 
statement. 


The operand field may contain any valid expressions, separated by commas. No alignment is 
performed before data generation. The values specified in the operand field of the FORM 
instruction are matched by position to the fields defined in the operand of the 
corresponding FORM definition statement. 


Missing operands (signified by contiguous commas) are replaced with zeros. If the number 
of operands in the instruction does not match the number specified in the definition, an 
error message is generated. 


if the symbol in the name field of a FORM definition is a mnemonic used in more than one 
type of instruction, the assembler assigns attributes to the instruction according to the 
following hierarchy: 


1. Machine and assembler instructions. 

2. User macros and user FORM instructions within user macros. 
3. User FORM instructions outside macros. 

4. System macros and FORM instructions within system macros. 


For example, if the programmer codes the following statements, the assembler treats the 
statement &A EQU "A as an assembly language statement (1. above) rather than a FORM 
instruction. 


NAME OPERATION OPERAND 
123 4 5 6 7 8{9] 10 11 1213 14 15 16 17/18/19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38.39 40 41 42 43.44 45 46 47 48 49 50 


lf the value of an expression is relocatable and not $SYSEG, the following conditions must 
be met; or a relocation error occurs and the expression is made absolute: 


1. The size of the corresponding FORM definition field must be 16 bits 
in length. 
2. The field must begin on a word boundary. 


If the operands of a FORM instruction statement do not use a complete byte, the remainder 
of the byte is unchanged. For example, the FORM definition statement, SIGN FORM 1,5,3 
specifies that 9 bit positions are required for the operands. When a FORM instruction, such 
as .A1 SIGN A<EQ>B,"B,0 calls this definition, the assembler uses two full bytes, but the 
last 7 bit positions of the second byte are zeros. 


If $SYSEG is used as an operand in a FORM instruction, the size of the corresponding 
FORM definition field must be 8 bits and start on a byte boundary. 


PADDING AND TRUNCATION RULES FOR FORM STATEMENTS 


Padding and truncation is done according to the following rules: 


ds Hexadecimal values are right-justified with zero fill on the left. If the - 
actual data is larger than the defined field, the data is truncated on 
the left. 
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2. Alphanumeric character constants are left-justified with blank fill on 
the right. If the actual data is larger than the defined field, the data is 
truncated on the right. 


3: Packed decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

4, Zoned decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

5. Integer string values and arithmetic values are right- justified with the 


sign propagated on the left. If the actual data is larger than the 
defined field, the data is truncated on the left and the sign is lost. 


The examples in Figure 8-4 illustrate certain padding and truncation rules. The first operand 
of TAB1, a hexadecimal 5 (0101), is truncated on the left and the two rightmost bits (01) 
are inserted in the 2-bit field defined by 2 in the FORM definition statement. If the value 
attribute of B in the second operand is less than C, the single bit position established in the 
corresponding definition statement is set to a binary 1. !f B is greater than C, the bit is set to 
a binary 0. 


The first A character constant (1100 0001 in EBCDIC) in the second TABLE statement is 
truncated on the right, and the remaining two leftmost bits (11) are assigned to location 
TAB2. Note, however, that all eight bits (1100 0001) of the second A character constant in 
the fourth operand position are retained at location TAB2+1. 


NAME OPERATION OPERAND 
7”. 


12 3-4 5 6 7. 8/9] 10 11 1213 14 15 16 17] 18] 19 20 21 22 23 24 25 26 27 28 29 3 31 32, 33.34 35 36.37 38.39 40 41 42 43.44.45 46 47 48 49 50, 


FORM... | 12,.1,5,8,.16 
ABLE. . “&, Beir sc, fet, “FA, ADDR, BYTE 


Figure 8-4. Examples of Padding and Truncation for Form Statements 


The following examples show a possible use of the FORM statement — redefining 
instructions to create a new language closer to English. In the first example, the “MOVE” 
instruction generates a MOVM machine instruction, using a FORM statement and a series of 
Equates. This corresponds to: MOVM BUFFERB(R2),@BUFFERA(R3). Assuming that 
BUF FERA is at address 63F A, the code generated is: 

602B 

63FA 


63FC 
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NAME OPERATION 


fl OPERAND 


1 23 4 5 6 7 8 10 11 12 13 14 15 16 17] 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


MTRECT | EQu.....31/@... 


a De ae een cee es Meee) See SOE Ae GEES SeeweS C Eee SOS (ee! Speen! ae aN ICS CO ee? GO! RE 
DIREC EQU. , + Tae ieee: be l. \ A ee ek a a dt ad tt — tA. tk 
in Q 
Nie Matias bod hs. = 3 me . os Re dh Srl ey os Se ee 0 ia eR ay 1 a $d 
\ QU 
\ are | 4 ‘ r re Ch, Fe 4 ‘ a . AD Bah é Be tele SE aches fol we aanibe.) Ge Sole Ui Suds HO L adhe oa 4 oe i ol 
lEMORY. rn EQU. . a oy 4 62 4 i ' L ee (ewes Wegean | Oo ile Bs. Ee i i an 


MOVE. | FORM... Bs By git scl Bi NOs wets Re ee ee 
BUFFERA WDD mia C!. Pace 

BUFFERB | WDD... | Ic'.se. ieee 
-. | MOVE _ |. | MEMORY, DIRECT. R2. INDIRECT, R35. a 
...... | BUEFERE SBUFFERA ee 


4 oo Seo ERE EE] SADE Ceres Coat! Loy ane! CORR Beaee Eeeate Kearns Agee! IMGT SYA OMe? (ne eee! Gee lamers Coe Cre re ees oy 


oe = dd At gt tt aces anne Sa) Werewsaes Meatres) oweraes Ps 


The next example shows a BRANCH FORM statement used alone to generate a BR machine 
instruction, or together with ROUTINE to generate a BSR machine instruction. Assuming 
that SUBROUT1 is at 2F3A, the code generated is: 

EAO7 


2F3A 


The last statement of this example, BRANCH REGISTER,R7, generates the code: EBO7. 


OPERATION OPERAND 


ee a ee ae oes ones anes ionene & a oe a ee Se oe ce as as Ss Ss Cs oT Cee oy 


ee ee es ae ee eS oe Ce es as See Sc Ss Cnneee Sons Saetee nee 


Ak tk ee a A. Sn Ce CS Ce i ine See Nene By 


a a ns 4s eo ee a A one 4. 4. 


| epee age Came! Careet rete) ewseen COSC Werree! Venceta were, erase! Eat LeMeY SE On) Raed Senn Geeees nee Engel By 


a aoe Seneey Cae Aa a 


1 a re Snes Coenen NEeen Connon Sennen cae Manes, Cnn © Aad —— a | — os 


A de Le te ee 


i ' a 4 kk. te A dk 


ar aa oe oes oe a Senet Ses Conn nS ee Sanna Cane SS a SR Ce ES SES ES OSE SOE mE 


A detailed example of the FORM instruction can be found in Appendix F. 
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If the length specification or the repetition factor is zero, no data is generated, but the 
location counter is aligned on the specified word or byte boundary. 


Examples of WDD and BDD statements are shown in Figure 8-2. In the last example, if M = 
N, the term 35 is generated. If M = N, no data is generated, but the location counter is set 
on a word address, which is given the name NAM4. 


OPERAND 


35.(2,M<BQ2N), 


1 a a 1 a 1 ‘i ‘ ‘ t Cees | * a . t 1 a €. . 1 


Figure 8-2. Examples of WDD and BDD Statements 


The value attribute of the symbol in the name field is the address of the leftmost byte after 
alignment. The length attribute is the length in bytes (specified or implied) of the first (or 
only) data field in the operand. 


Omitted operands, signified by a comma without a data value, indicate a zero byte or word. 
The last data value in a string of multiple operands must be a specified data value, not an 
omitted operand. 


Consider the following example. Notice that an arithmetic constant, such as 45, uses two 
bytes. 


Statement Generated Data 
WDD _ ,12,, ,45 00 00 Word 1 


00. OC~ Word 2 
00 00. Word 3 
00 00 Word 4 
00 2D Word5 


If the data value is a relocatable expression other than $SYSEG, the length specification and 
the repetition factor have the following restrictions: 


1: The length attribute must be resolved to two bytes. If the length is 
not specified, two bytes are assumed. 


2: Alignment must be on a word boundary. 


For $SYSEG, the length attribute is 1 and alignment must be on an odd boundary. 
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Literals (which are always relocatable) in a WDD or BDD statement require special 
consideration. If a literal term is used in the WDD or BDD statement, the implied length and 
repetition attributes are (2,1). If other specifications are included, they refer to the literal 
term itself, but not to the symbol defined in the name field. Consider this statement: 


NAME f 
a 10 11 1213 14 15 16 17] t8l 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 36 36 37 38.39 40 41 42 43.44 45 46 47 48 49 50 
The length attribute of the literal C‘ABCD’(5,2) is 10; but the length attribute of the 
symbol B1 is 2, because the operand is a relocatable term. In all other cases, the symbol in 
the name field receives the length attribute of the first data field in the operand. 


OPERATION OPERAND 


If the location counter (*) is referenced in the operand field, the value attribute of the 
symbol in the name field replaces the operand. For example, TAG WDD *,*,* generates 
three words of data, each assigned the value attribute of TAG. If TAG is equal to to 1004, 
then 1004 1004 1004 is generated. 


For example, the following statement specifies that two 8-byte fields of all zeros are to be 
generated. TAG represents the address of the first byte of generated data. 


OPERATION OPERAND 


NAME 


12.3 4 5 6 7 8/9] 10 11 1213 14 15 46 17148119 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38.39 40 41 42 43.44 45 46 47 48 49 50. 


If the location counter is pointing to OOFE, TAG is equal to OOFE and the storage locations 
are as follows. (The last byte is 010D or TAG+15.) 


Locations Contents 

OOFE 00 OO 

0100 00 OO : 

0102 00 00 First operand 
0104 00 OO 

0106 00 O00 

0108 00 00 

010A 00 00 Second operand 
010C 00 OO 


If the location counter is pointing to an odd-byte address when a WDD statement is 
encountered, the assembler automatically updates the counter to the next word boundary 
and does not affect the contents of the odd-byte address. 


In the preceding example, if the location counter is pointing to OOFD, the assembler updates 


the counter to OOFE and the contents of OOFD are unchanged. The storage locations are as 
follows. - 
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9. LISTING CONTROL STATEMENTS 


The listing control statements control the printing of the lines of code generated by the 
assembler. The statements themselves are used only for the source listing and are not carried 
over to the object program. 
The assembler mnemonics and functions of the listing control statements are: 

TITLE = Identifies the listing. 

EJECT Starts a new page. 

SPACE Inserts blank lines. 

PRINT Specifies the details to be printed. 


TITLE, SPACE, and EJECT statements do not appear in the source listing. 


TITLE — IDENTIFY LISTING 


The TITLE statement specifies the program ID and the heading to be printed on each page 
of the listing. The format of the TITLE statement is: 


Operation Operand 


Symbol Character string constant 
or blank 


The first symbol (except a sequence symbol) in the name field of any TITLE statement is 
printed in the program ID area at the top of each page of the entire listing. The name field 
of all other TITLE statements must contain a sequence symbol or a blank. 


The character string in the operand field specifies the heading for each page. Any variable 
symbols in the character string are resolved. The resolved character string must not be more 
than 90 characters. 


When the TITLE statement appears in a source program, the assembler ejects the current 
page and prints the specified title on the top of the next page. This title is printed on the 
top of each page until another TITLE statement appears. 


In the following example, PGM1 and FIRST SUBROUTINE is printed on all sheets of the 
listing until another TITLE statement appears: 
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OPERAND 


; NAME OPERATION 
2 9 45-67 8 TLE 


POMI - 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


C' ETRE eine UTINE.". . per eee 


te te et Sh Se pa a as oe cae, oe a 


Assume that this heading has been printed on six sheets, and the following TITLE statement 
is encountered while the sixth sheet is being printed. 


OPERAND 


The assembler halts the printing and ejects the sixth sheet. The new heading, SECOND 
SUBROUTINE, is printed on the seventh sheet. Printing then continues with the seventh 
sheet. Note that a sequence symbol in the name field does not change the program !D. 


EJECT — START NEW PAGE 


The EJECT statement ejects the remainder of the page and resumes the printing at the top 
of the next page. The format of the EJECT statement is: 


Operation Operand 


Sequence Not used — ignored by the 
symbol or assembler 
blank 


The EJECT statement can be used to separate routines in a program listing. Two successive 
EJECT statements leave the remainder of the current sheet plus the entire next sheet blank. 
A TITLE statement immediately followed by an EJECT statement produces a page that is 
blank except for the heading specified in the TITLE statement. 


SPACE — INSERT BLANK LINES 


The SPACE statement inserts one or more blank lines in a listing. The format of the SPACE 
statement is: 


Operation Operand 


Sequence Absolute 
symbol arithmetic expression 
or blank 
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The assembler evaluates the expression in the operand field to determine the number of 
lines to leave blank. Symbols in the expression must be previously defined. If the number of 
lines to be left blank exceeds the number left on the current page, the SPACE statement 
functions as an EJECT statement, and the next line is printed on the top of the next page. 
An example of a SPACE statement is: 


NAME [ OPERATION OPERAND 
“12 3945 67 AE 10 11 12 13 14 15 16 17} 18} 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
eee | 
A. 


CACEQ>B)*St 1. eerie ee rere 


ee ee as een Se Oe Pee anes See 5 at a dt Se Oe ee ee ee ee ee es ee ees Seen 


PRINT — PRINT OPTIONAL DATA 


The PRINT statement controls the extent of the printing. The PRINT statement cannot 
appear within a macro. The format of the PRINT statement is: 


Operation Operand 


Sequence One to four operands 
symbol separated by commas 
or blank 


The operands, which may appear in any order, specify the amount of data to be printed. 
The two choices for each operand are: 


1. ON A listing is printed. 
OFF No listing is printed. 
2. GEN All statements generated from a macro instruction 
are printed. 


NOGEN Only the macro instruction is printed. 


3. DATA Generated data is printed in full. 
NODATA Only the leftmost eight bytes of generated data are 
printed. 


4. COND Conditional statements are printed. 
NOCOND Conditional statements are not printed. 


The operand cannot contain a variable symbol. Each condition specified by the operands 
remains in force until it is changed by another PRINT statement. A program can contain 
any number of PRINT statements. If a PRINT statement does not appear in a program, or 
until it does appear, the assembler assumes the following conditions: PRINT 
ON, NODATA,GEN,NOCOND. 


For example, the following statement requests the assembler to assemble 256 bytes. of 
zeros: 


OPERAND 


28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47-48 49 50 


If the operand DATA is included in the last PRINT statement, the listing contains all 256 
bytes of zeros. If the last PRINT statement included the operand NODATA, only eight 
bytes of zeros are listed. 


If the operands of a PRINT statement are contradictory (such as OFF and DATA), the 
assembler determines the printing according to the following priority: 


4 ON or OFF 
2. GEN or NOGEN 
2: DATA or NODATA, and COND or NOCOND 


When NOCOND is specified, conditional statements with errors are printed unless OFF is in 
force, or the statement occurs in a macro when NOGEN is in force. 


Note that the line numbers generated will not be in sequence when NOGEN or NOCOND is 
specified. Jumps in the line numbers indicate that statements were not listed due to NOGEN 
or NOCOND. However, if the suppressed statements contain errors, the error messages still 
refer to lines which do not appear in the listing. 
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10. MACRO LANGUAGE AND CONDITIONAL 
ASSEMBLY STATEMENTS 


The macro language and conditional assembly statements are so closely related that it is 
difficult to explain either concept by itself. Thus, this section is divided into two 
subsections. The first explains the basic structure and application of the macro language. 
Sufficient information is supplied to write a simple macro definition and instruction. The 
second subsection deals with specific conditional assembly statements and their use within 
more complex macros and assemblies. 


MACRO LANGUAGE 


The macro language provides a convenient way to generate a desired sequence of assembler 
statements many times in one or more programs. The principal features are the macro 
definition and the macro instruction. The macro definition is a composite piece of coding 
which serves as a prototype for generating source statements. The macro instruction is a 
single statement which calls the macro definition for assembly and assigns values to the 
variable symbols in the macro definition. 


The macro definition is written only once; the macro instruction is written each time a 
programmer wants to generate the desired sequence of statements. This facility can help 
simplify the coding of a program and reduce the chance of coding errors. 


Macro definitions must appear in a source program before all PUNCH statements and 
statements pertaining to the first control section; consequently, only EJECT, PRINT, 
SPACE, TITLE, ICTL, ISEQ, and comment staternents can validly precede the first macro 
definition. All of these statements except ICTL can appear between macro definitions. 

A macro definition cannot appear within a macro definition; however, one macro can call 
another macro. 


MACRO DEFINITION 


A macro definition has four parts: 


1. Header statement 

2: Prototype statement 
3. Model statements 

4. Termination statement 
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HEADER STATEMENT 


The header statement identifies the beginning of a macro definition. It must be the first 
statement of a macro definition. The format of the header statement is: 


Operand 


Blank — ignored by the assembler 


PROTOTYPE STATEMENT 
The prototype statement specifies the mnemonic operation code and the format of macro 


instructions that call the macro definition. The prototype statement must be the second 
statement of every macro definition. The format of the prototype statement is: 


Operation Operand 


Symbolic Mnemonic O — 35 symbolic parameters 
parameter operation 
or blank code 


The name field may be blank, or it may contain a symbolic parameter. 


The mnemonic operation code in the operation field is the macro name used to cail the 
macro definition for assembly. This code must not be used in another macro definition, nor 
can it be a recognized mnemonic of a machine or assembler instruction. 


The operand field may contain 0 through 35 symbolic parameters, separated by commas. 
The first four characters of a symbolic parameter should not be &SYS. Comments can 
appear only if symbolic parameters are present. 


The symbolic parameters in the name field and the operand field represent variable values 
that are supplied by the programmer when he calls the macro for assembly. Subsequent 
model statements use these symbolic parameters. 


The operands in a prototype statement can be positional or keyword. Keyword and 
positional operands cannot both be used in the same prototype statement. 


Positional operands require that the operands of a macro instruction be written in the same 
order as the corresponding symbolic parameters of the prototype statement. Positional 
operands cannot have a default value and must begin with an ampersand (&) followed by 
one to seven alphanumeric characters, the first of which must be alphabetic. Examples of 
positional operands are &PAR1, &P, &P2. 
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Keyword operands may appear in any order in the macro definition and the macro 
instruction, because the parameters are recognized by the keyword, not by the order or 
position of the symbolic parameter in the prototype statement. Keyword operands may be 
assigned default values. A default value must be a standard value, not a variable symbol. 
Keyword operands are similar to positional operands, except that keyword operands are 
immediately followed by an equal sign and optionally followed by a standard value. If a 
value is not assigned, the default value is null. Examples of keyword operands are: 
&PAM1=22,&P=C’ABCD’, &PAM3=. 


The length of a prototype statement can be any number of lines. Continued lines must end 
with a semicolon. A semicolon may not be the first character of a continuation line. 


MODEL STATEMENTS 


Model statements are the macro definition statements from which the assembler language 
statements are generated. Zero or more model statements may follow the prototype 
statement. In the use of special characters, model statements must follow the same rules as 
macro instruction operands. The rules pertaining to special characters in macro instructions 
are discussed under Special Characters in a Macro Instruction \ater in this chapter. Model 
statements must also follow the normal continuation line rules, and statements generated 
from model statements must not require more than 160 characters. Only generated 
statements appear in the listing. The format of the model statement is: 


Name Operation Operand 


Any symbol Instruction or Any symbols or terms 
or blank variable symbol 


The name field may be blank, or may contain a symbol. Because a sequence symbol inside a 
macro definition is local to that definition, the same sequence symbol can be used in 
another macro or outside the macro definition. However, within the same macro definition, 
a sequence symbol can be generated only once. Thus, a sequence symbol may be used in 
more than one model statement, provided that the statements which duplicate it are skipped 
due to conditional assembly. Note that because prototype statements are not generated, the 
symbol in the name field of a prototype statement can be duplicated and generated in a 
model statement. The characters * and . * or a sequence symbol cannot be substituted for a 
variable symbol in the begin position of a model statement. If the model statement is an 
inner macro instruction, the name field must follow the rules for macro instructions. 


A variable symbol can be concatenated with other characters in the name field. 


The operation field may contain a machine instruction, an assembler instruction, a macro 
instruction, a form instruction, or a variable symbol. However, the following assembler 
instruction mnemonics cannot be used in the operation field of a model statement: 
MACRO, PRINT, ISEQ, ICTL, and END. Variable symbols cannot be used to generate an 
ADO, AGO, ANOP, SETA, SETC, PUNCH, MEXIT, GBLA, GBLC, MNOTE, CSECT, COM, 
MACRO, SEG, PRINT, ISEQ, ICTL, or END mnemonic, or macro instruction mnemonic 
operation codes. 
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The operand field may contain ordinary, variable, or sequence symbols, or other terms, 
depending upon the instruction in the operation field. A symbolic parameter in the operand 
field of a model statement must first be defined in the prototype statement. Comments can 
appear after the last operand. No substitution is made for variable symbols in a comment. 


A model statement may be a comment statement. An asterisk in the begin column indicates 
that the entire line is a comment statement. The assembler converts a model comment 
statement into an assembler language comment statement. 


The programmer may also write comment statements in a macro definition which are not to 
be generated. These statements must have a period in the begin column, immediately 
followed by an asterisk and the comment (.*comment). 


The line following a PUNCH model statement is the only exception to model statement 
format rules. Format rules do not apply because the line contains output data, and all 
characters between the begin and end positions are in free format. Substitution is performed 
for all variable symbols between the begin and end positions. 


Relationship of Model and Prototype Statements: Figure 10-1 illustrates the relationship 
between model statements and the prototype statement. Notice that the symbolic 
parameters &TAG1, &TAG2, &TAG3, and &TAG4 are defined in the prototype statement 
before they are used in the model statements. 


NAME OPERATION 


fobesbes 


8119 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40.41 42 43 44 45 46 47 48 49 50 


1234 5 67 819] 10 11 1213 14 15 16 17 


{BEGIN | DIVIDE | {TAS gf TAG2 LL #TAG 3, #TAGH. — PROT E We 
BEGIN . STO. Be a . ES Se ee a i. 
etek ee da ea Rea - 0 Tey ieee ee ae ST AGL, 5S. ta ie a et es af on a rere L 
pr oc tr cece 
Bytag 5.70 TAGY,S. .. aN MPa CTEM oe ee eee eet 
a Se Seay OD ene aan” See SAVE, 5 o4 fee rire o Pee Jewel! Weer (oese eee n A Se Pf 
= END. 1 ae ‘ tp 4s 1 a ieee) ieee) ee Cea ey Eas meas Clee 8 Bo det tb. 
zs ee eer 2 ae ee” Se ee Peart eee tate eer eee 
_ a te pe per rd ete fe oe se ak 
ie eat 4 Eves eres Sees a? Odie SR SP MY USS in. Ste heoetetad [a eee aa Vere Benue Ban bad Bunt GeseOR Coes Uae) DEED OS Om 
aE ob beh Dj bh Aes ere M »? yo ni ae Te on eS ah PB eens Se pe ag ae a ed or ft a 
= L 4 A i a a a 2 ey ‘ i a Te oe, eee Se ees | . a a ee | a ne Stak 1 a - 1. 7 oo oF eet Wenceee! nth ay 
ae ef rad 74 oe f ‘ x, 
Figure 10-1. Macro Definition Pe eS eed eee ee 
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TERMINATION STATEMENT 


The termination statement specifies the end of a macro definition. It can appear only once 
within a macro definition and must be the last statement of the definition. The format of 
the termination statement is: 


Operation Operand 


Sequence Blank — ignored by the assembler 


symbol or 
blank 
MACRO INSTRUCTION 
The macro instruction performs the following functions: 

1. Calls the macro definition for assembly. 

2. Assigns values to the symbolic parameters in the macro definition. 
The macro instruction closely parallels the prototype statement. The values in the macro 


instruction are equated to the symbolic parameters in the prototype statement. The format 
of the macro instruction is: | 


Operation Operand 


Ordinary Mnemonic 0 — 35 operands 


symbol, operation 
sequence code 
symbol, 

or blank 


The name field may be blank, or it may contain an ordinary symbol or a sequence symbol. 
An ordinary symbol is defined in the assembly only if a symbolic parameter is both in the 
name field of the prototype statement and in the name field of a model statement. If the 
model statement which has the symbolic parameter in its name field is skipped as a result of 
conditional assembly, the statement is not generated. Consequently, the ordinary symbol in 
the name field of the macro instruction is also not generated. 
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A sequence symbol in the name field of the macro instruction is never carried over to the 
name field of the generated model statement. This sequence symbol can only be used in the 
operand field of an AGO statement — never as the second operand of an ADO statement. 


The mnemonic operation code in the operand field must be previously defined in a macro 
definition or in the system macro library. 


The number of operands in the operand field may not exceed the number of operands in the 
prototype statement. An operand can have up to 127 characters. 


POSITIONAL OPERANDS 


If the prototype statement has positional operands, the operands of the macro instruction 
correspond to the symbolic parameters in the prototype statement, and the operand values 
are applied to the symbolic parameters in sequence. If the macro instruction has fewer 
operands than the prototype statement, the unmatched symbolic parameters in the 
prototype are assigned null values, not blanks. Two contiguous commas in the operand field 
indicate an omitted operand, which is also assigned a null value. The examples in Figure 
10-2 illustrate positional operands. | 


Prototype: &LABEL POS &TAB1,&TAB2,&TAB3 Values: &TAB1 = 42 

Instruction: .FIRST POS 42,15,63 &TAB2 = 15 
&TAB3 = 63 

Instruction: .SEC POS 16,,2 Values: &TAB1 = 16 
&TAB2 = null 
&TABS = 2 


Figure 10-2. Macro Instruction — Positional Operands 


KEYWORD OPERANDS 


If the prototype statement has keyword operands, the macro instruction must also have 
keyword operands. The instruction keyword, which is all characters before the equal sign, 
must directly match the keyword in the prototype operand, except that the instruction 
keyword operand is not preceded by an ampersand. The value following the equal sign in 
the macro instruction is assigned to its corresponding symbolic parameter. Symbolic 
parameters not matched by a macro instruction operand retain their default value. The 
examples in Figure 10-3 illustrate keyword operands. 
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Prototype: &LBL KEY &PARM1=5,&PARM2=,&PARM3=C’VALUE’ Values: &PARM1 = 100 

instruction: .THD KEY PARM3=C’PRICE’, PARM1=100 &PARM2 = null 
&PARMS = C’PRICE’ 

Instruction: .FOUR KEY PARM1=ABCD,PARM2="7B Values: &PARM1 = ABCD 
&PARM2 = “7B 


&PARM3 = C’'VALUE’ 


Figure 10-3. Macro Instruction — Keyword Operands 


SPECIAL CHARACTERS IN A MACRO INSTRUCTION 


A macro instruction operand may consist of any combination of up to 127 characters, 
provided the syntactical rules for the following special characters are observed. These 
characters have special meanings in a macro instruction operand. 


e escape character (#) e comma 

® ampersand | e semicolon 
@ apostrophe e blank 

® parentheses 


Escape Character 


The first character after an escape character retains its literal value. Therefore, if a special 
character is to retain its literal value, it must be preceded by an escape character. For 
example, the following operand field has three operands: 

#(C#.B, #,#, XYZ 

eee saree! Smememene Soe ener” 


1 2 3 
Escape characters are part of the operand value and are carried over to the model statements. 


Ampersand 

An ampersand followed by a letter indicates the start of a variable symbol. During assembly, 
the current value is substituted for all variable symbols found in a macro instruction. In the 
following example, only &V1 is substituted. 


C’ARV1#&V2',C'#&V3 F&V4',ABTX’&V1 
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Apostrophe 


An apostrophe immediately preceded by the letter C signifies the start of a character string 
constant. The character string constant extends to the next apostrophe. Parentheses, 
commas, and blanks lose their special meanings when they are enclosed in a character string 
constant, as in the example: 


C’A,BC( = 539° 


The comma, blanks, and left parenthesis are part of the character string constant. In any 
other context, the apostrophe retains its literal value. 


Parentheses 


An operand beginning with a left parenthesis and ending with a right parenthesis signifies an 
operand sublist. Within a sublist, the comma is a suboperand separator, not an operand 
separator. Special characters, other than the comma, retain their special meanings within a 
sublist. Parentheses that do not specify an operand sublist retain their literal value. 
Examples of operands with parentheses are: 


A,(B,C) Two operands: [A] [(B,C)] 


A(B,C) One operand — operand does not begin with a left 
parenthesis 


(A+B)/2(R,4) One operand — operand does not begin and end 
with matching parentheses 


Comma 


The comma separates operands or suboperands, unless the comma is inside a character string 
constant, preceded by an escape character, or follows a left parenthesis that is not the 
opening parenthesis of a sublist. In these three cases, the comma retains its literal value. 
Examples of operands with commas are: 


A,B,C Three operands: [A] [B ] [C] 

A#,B#,C One operand: comma preceded by # 

B(C,4+K One operand: comma preceded by ( 
Semicolon 


The semicolon indicates line continuation. Characters following a semicolon are considered 
comments. The semicolon cannot be the first character of a continuation line. The current 
line continues with the first nonblank character of the next line, as in the following 
example: 
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A,BHCD,52,;HERE HERE is acomment. The four operands are: 
CON [A ] [BHCD ] [52] and [CON]. 


Blank 


A blank signifies the end of the operand field. Characters following a blank are considered 
comments. 


SUBLISTS IN MACRO INSTRUCTIONS 


To group a number of suboperands as a single symbolic parameter value, the macro 
instruction operand is. written as a sublist. A sublist consists of one or more suboperands 
separated by commas and enclosed in parentheses. Each suboperand has form identical to an 
operand. The entire sublist including the parentheses is considered one macro instruction 
operand. 


Omitted suboperands have a null value. However, the operand () is considered a character 
string, not a sublist with all the suboperands omitted. The operand limit of 127 characters 
applies to the entire sublist. Examples of valid sublists are: 


(A,2,4,16) Four suboperands 


(A+40,B(2,6),(N,M),240/C+X) Four suboperands 


SUBLISTS IN MODEL STATEMENTS 


In a macro instruction operand, a sublist can assign a set of values to a single symbolic 
parameter of the macro definition. Any model statement may reference the entire symbolic 
parameter, but only a SETA, SETC, or ADO statement can reference the suboperands of the 
symbolic parameter. 


The format used to reference a suboperand is: symbolic parameter (n). 
The subscript n is an arithmetic set expression that refers to the position of the suboperand 
being referenced. For example, &LIST(2) references the second suboperand of the symbolic 


parameter, &LIST. 


lf the sublist (A,,C20,’192’,(N,M)) is a macro instruction operand corresponding to the 
symbolic parameter &FIEL D, the values assigned to the suboperands are: 


FIEL D(O) = null 
FIELD(1)=A 
FIELD(2) = null 


FIELD(3) = C20 


10-9 


FIEL D(4) = '192’ 

FIELD(5) = (N,M) 

FIELD(6) through FIELD(n) = null 
A subscripted reference to an omitted sublist element, such as FIELD(2) above, is assigned a 
null value. If the macro instruction operand is a simple operand, rather than a sublist, the 
macro instruction can refer to the operand value by the symbolic parameter without a 
subscript, or by the symbolic parameter with a subscript of 1. All other subscripted 
references have a null value. 
Suboperands of sublists within a sublist (for example, N in FIELD(5) above) cannot be 
referenced in a model statement. 
SUBSTRING NOTATION 
Substring notation allows the programmer to reference part of a macro instruction operand 
or a character string constant. Substring notation consists of a symbolic parameter or a 
character string constant, immediately followed by two arithmetic set expressions separated 
by a comma and enclosed in parentheses, as in the examples: 

&NAME (2,4) 

C’AB24CFG’(&P1,2) 
The first expression indicates the position of the first character to be included in the 
substring. The second expression indicates the number of consecutive characters (beginning 
with the character indicated by the first expression) to be included in the substring. 
If the substring specifies more characters than are in the macro instruction operand or in the 
character string constant, only the number of available characters are supplied. If the 
starting character is outside the range of the string, a null character is supplied. 


Substring notation has the following limitations: 


1. Substrings can only be specified for character string constants and 
macro instruction operands. 


2. A substring of a sublist cannot be specified. 


3. A substring reference can only be used as a term in a conditional 
assembly statement. 


Consider the example in Figure 10-4. 
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Prototype: &LABEL WRITE &P1,&P2,&P3 Values: &P1 = 24 
Instruction: .FIRST WRITE 24,C’ABCDE’,734A &P2(3,3) = ABC 


&P3(1,2) = 73 


Figure 10-4. Examples of Substring Notation 


CONCATENATION OF VARIABLE SYMBOLS 


Variable symbols in model statements can be concatenated so that the name field, operation 
field, or operand field can be modified by a macro instruction. Thus, the mnemonic 
instruction DIV can become DIVA, DIVB, or DIVC, and the operand FIELD can become 
FIELDA, FIELDB, or FIELDC. 


The example in Figure 10-5 illustrates concatenated operation codes and operands in a 
macro definition. 


OPERAND 


MACRO DEFINITION "tt es 


Bh aly gs a) oe 


$71. 472, sT3, a4, ers. 16,077 

AVE, S oe ad 

ites es oe oe ee 

| Tite Gs He dai Nadiane ta eaice ce at 
VES. 


MACRO INSTRUCTION Sraiuaiaiioaiemarannmaiaion Be Soetadenteetecds 4 acetate 
ERE. | le DI. VIDE. o ot. FIELD, B, D,: D 344A, ! WR. foe es Coe one Cone cen Oc Oo CT 
tte MACRO EXPANSION * i we ictent 4 tert tet at a 


EL pa 2h 

FIELDD iS: A424 1 ae aeons Be ena See Se, ae he a 

. 2 ES iy aaa RE? Cea ae! enn Ee, Ra Lm RA VT CORSA CPT ei SRT Hn] WEEN FCN OREN LSC CORIO NEST RORY VE COR ee 

ELDA, 5 Bo ee eB ed td fa a on Gp ll ded ae ok 

2 AVE,S. pels! ods, ee WS es cage, | Ey Ore See en ener Lacey Seeeet Beem Restaat! nmenns inane s UNE! ROY REO 

<P se BAG ro SE tl he fh a a 

—. onl The oe real a o_o = _ a peleeemetelnn ae hone — | Sie gt a a oe on nt on Son Y CY mena! Smee Meme 


SD ced gias Bard entaer ere Shs. 3 des] Jind, dl gas he Bee, oh Se Ne re Peet Deer ear | Ree eee “ oan See A cise Dalene oir 8 book a a 4 ‘ thik 8 els =o. yee CO | L 
12 3-4 5 6 7 8]9}10 11 121314 15 16 17] 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
ee eet pa SS Se Ee es ee ee ee ne Oe ee ee ee ee a a ee i 

Figure 10-5. Concatenation of Variable Symbols 
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NESTING OF MACROS 


A model statement in a macro definition may be a macro instruction that calls another 
macro. Model statements used as macro instructions are called inner macro instructions. 
Macro instructions not used as model statements are called outer macro instructions. 


Rules for inner macro instructions are the same as for outer macro instructions. Symbolic 
parameters in an inner macro instruction are replaced by the corresponding characters of the 
outer macro instructions. Sublists of an outer macro instruction cannot be passed as a 
sublist to an inner macro instruction. 


An outer macro instruction is a first level macro instruction. The first inner macro 
instruction is a second level instruction, the second inner macro instruction is a third level, 
and so on. Five levels of macro instructions are allowed. Within each level, any number of 
macro instructions may be used. 


Figure 10-6 demonstrates the inner and outer macro instructions and the various levels of 
instructions. . 


Source 

Prqgram 
MACRO MACRO MACRO 
READ COMPUTE DIVIDE 
Model Mode! Model 

READ Model Modet Model 
COMPUTE Mode! Model 
Model *% 


DIVIDE MEND 
ee 


Model Mode! 
END Model MEND rk 
\ MEND \ \ 
\ 
\ LY ‘ 
\ \ N 

—- =< Outer macro —_—— =< Inner macro — =< — —Inner macro 
instruction instruction instruction 
(first Jevel) (second level) (third level) 


Figure 10-6. Nesting of Macros 


MNOTE — GENERATE ERROR MESSAGE 


The MNOTE statement is used only in a macro definition to generate an error message. The 
format of the MNOTE statement is: 


Operation Operand 


Sequence Severity code, message or 
symbol or message only | 
blank 
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The severity code may be W — warning error, or F — fatal error. If the first character is not a 
W or an F followed by a comma, the statement is treated as a warning error. 


The message may be any EBCDIC characters. The line may not be continued, and no 
substitution is performed. Examples of MNOTE statements are: 


Statement Generated Message 
MNOTE W,message W MNOTE *message* 
MNOTE F,message F MNOTE *message* 
MNOTE Fmessage W MNOTE *Fmessage* 
MNOTE message W MNOTE *message* 


MEXIT — ALTERNATE TERMINATION FOR MACRO DEFINITION 


The MEXIT statement indicates an alternate termination point for a macro definition. The 
format of the MEXIT statement is: 


Operation — Operand 


Sequence MEXIT Blank — ignored by the assembler 
symbol or 


blank 


When an MEXIT statement is processed, the next statement processed by the assembler is 
the statement immediately following the macro instruction that called the macro. If MEXIT 
is skipped due to conditional assembly, MEXIT is ignored. The MEXIT statement cannot 
replace MEND as the final statement of a macro definition. 


SYSTEM VARIABLE SYMBOLS — &SYSNDX AND &SYSECT 


The system variable symbols, &SYSNDX and &SYSECT, are automatically assigned values 
by the assembler. These symbols can be used only in the name, operation, and operand 
fields of statements in macro definitions. They may not be defined as symbolic parameters, 
nor can they be assigned values by SET statements. 


&SYSNDX 
Assigned an original value of 0001 for the first macro instruction processed, &SYSNDX is 
increased by 1 for each inner or outer macro that is processed. Thus, the value of 


&SYSNDX represents the current number of macro calls processed up to and including the 
current call. 
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The value of &SYSNDX always remains constant within a macro level, regardless of how 
_many inner macros are called. When the assembler returns to a given macro (from an inner 
macro), the value of &SYSNDX in effect is the value it had when the macro was first called. 


Figure 10-7 illustrates the changing value of &SYSNDX. The numbers to the left of the 
model statements indicate the value of &SYSNDX as each statement is processed. 


The variable symbol &SYSNDX can be concatenated with other characters to form unique 
names in statements generated from the same model statements. Thus duplicate names can 
be avoided when a macro is called more than once. 


&SYSNDX as an arithmetic term in a SETA expression produces an arithmetic value. In 
other contexts, the value of &SYSNDX is a four digit number, including leading zeros. 


The example in Figure 10-8 shows how &SYSNDX can be used. All statements in the 
example are part of the same macro, which is called by the eighth macro instruction 
processed during the assembly. 


Source 
Program 
MACRO MACRO 
READ COMPUTE 
Model 2 Model 
1 Model 2 Model 
1 Model 2 Model 
COMPUTE <————--——————-——_ MEND 
1 Model 
READ 1 Model 
1 WRITE ———“# MACRO 
1 Model WRITE 
1 Model 3 Model 
1 Model 3 Model 
—— MEND 3 Model 
END MEND 


The numbers to the left of the statements indicate the value of &SYSNDX at that particular 
point in the program. 


Figure 10-7. Using &SYSNDX with Inner and Outer Macros 


Model Statements: 


&SET1 SETA &SYSNDX+10 Values: &SYSNDX+10 = 8 + 10 = 18 (in the SETA statement) 
&SET2 SETC &SYSNDX &SYSNDX = 0008 (in the SETC statement) 
L&SYSNDX FORM 2,6 L&SYSNDX = L0008 (in the concatenated symbol!) 


Figure 10-8. Examples of &SYSNDX 
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&SYSECT 


The variable symbol &SYSECT represents the name of the control section in which a macro 
instruction appears. The value assigned to &SYSECT is the name of the last CSECT or COM 
statement that precedes the current macro instruction. If no CSECT or COM statement 
appears before the macro instruction, &SYSECT has the value of two blanks. 


In any given macro definition, the value of &SYSECT is constant, that is, the name of the 
last CSECT or COM statement before the macro instruction. During nested macro calls, 
&SYSECT in an inner model statement refers to the last active CSECT or COM statement in 
the next outer macro definition. Note the value of &SYSECT in Figure 10-9. 


Source Program 
FIRST COM MACRO , MACRO 
Model THRD COM 
"ee Model se Model 


READ SCND COM oo CSECT 


ees SCRIP Model 
ea CSE cr Model 
Model MEND 
Model 
END MEND | 
Salus of &SYSECT is FIRST. Value of &SYSECT is SCND. 


Figure 10-9. Example of &SYSECT 


CONDITIONAL ASSEMBLY STATEMENTS 


Conditional assembly allows the programmer to specify assembler language statements 
‘which may or may not be assembled, depending upon conditions evaluated at assembly 
time. These conditions are usually tests of values, which may be defined, set, changed, or 
tested during assembly. Thus, different sequences of statements can be generated from the 
same macro definition. . 


Almost all conditional assembly statements can be used inside or outside macros, although 
their primary use is inside macros. The macro language itself can be considered a type of 
conditional assembly. 


The conditional assembly statements are: 


SETA Assigns arithmetic values to set symbols. 
SETC Assigns character values to set symbols. 
GBLA Defines a SETA statement as global. 
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GBLC Defines a SETC statement as global. 
ADO Sets up a source statement generation loop. 


AGO Specifies a branch to another statement; skipped statements 
are not assembled. 


ANOP Specifies an assembly no-operation statement. 


SET STATEMENTS 


The SET statements assign arithmetic and character values to set symbols which can then be 
referenced in subsequent source statements. When the defined symbol appears in a 
subsequent statement, the assembler replaces the symbol with the assigned value. 


If two SET statements assign different values to the same set symbol, the last value assigned 
to the symbol is the value currently in effect. 


SET statements can appear within or outside a macro definition; however, a set symbol 
defined within a macro is local to that macro unless it is specifically declared global. 


A set symbol defined outside a macro can be referenced for its assigned value from 
anywhere in the source program. The same variable symbol may not be used as a symbolic 
parameter and as a set symbol within the same macro definition; nor can the same variable 
symbol be used in a SETA and a SETC statement, if the symbols are defined within the 
same scope. 


SETA — ASSIGN ARITHMETIC VALUE TO SET SYMBOL 


The SETA statement assigns arithmetic values to set symbols. The format of the SETA 
statement is: 


Set symbol SETA 


The set symbol in the name field may not be generated as a result of substitution, that is, 
the name field must be explicitly coded. 


Operand 


Arithmetic set expression 


The expression in the operand field is evaluated as a 16-bit arithmetic value which is 
assigned to the set symbol in the name field. 
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An arithmetic set expression may consist of one term or an arithmetic combination of 
terms. The procedure used to evaluate an arithmetic set expression is the same as that used 
to evaluate arithmetic expressions in assembler language statements. The only difference 
between the two expressions lies in the terms that are allowed. The terms that may be used 
in an arithmetic set expression are: 


Arithmetic Terms Example 
Arithmetic constants 2463 or ““FOF2 
SETA symbols &S1 | 
&SYSNDX references &SYSNDX 
Count attribute references K'&P 1 
Number attribute references N’&P2 

Character Terms Example 


Symbolic parameters, including 
sublist and substring 


references &P3(&P1) 
SETC symbols, including 

substring references &S 
Substrings of character constants C’ABCDE’ (2,3) 
&SYSECT references &SYSECT 
Character constants C’ABC’ 


Any character term except a character constant may appear as a single term, or be used as 
an operand in arithmetic and logical operations, provided the resultant character string 
contains only numeric characters. When used in this context, the value of the character 
string, that is, its decimal equivalent, may not exceed 65,535. 


Any character term may be used as an operand in a relational operation. In this context, the 
term is always treated as a character constant, even if it consists solely of numeric 
characters. 


Since conditional assembly statements represent the tools for source statement generation, 
they cannot themselves be the object of substitution, nor may they be concatenated. For 
example, if the character constant C’&P1’ appears as a term in an arithmetic set expression, 
its value is &P1 regardless of the actual value of &P1. 
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The following are examples of va/id SETA statements if &P1 and &P2 are symbolic 
parameters with values (64,4,ABC) and AB246C, respectively. 


&S1 SETA 8 

&S2 SETA “AA 

&S3 SETA &S1+&S2 

&S4 SETA &P 1(1)+&P2(&P 1 (2),2) 

&S5 SETA (&P1(3) <EQ>C’ABCDE'(1,3)+&P2(4,1))/2 
&S6 SETA &P2(3,3) << EQ>C’246’+N‘&P 1 


Examples of invalid arithmetic set expressions are: 


At+2 Reference to ordinary symbol 
=C’AB' Literal term 
2+L’BETA Length attribute reference 


&P1(1)<EQ>64 &P1(1) is considered a character string, the second 
operand in the relation must be coded as a character 
term, that is, C’64’ 


P’-240’ String constant other than a character constant 
C‘ABC’ Character constant not used in a relation 
&P1&P2 Concatenation of symbols 


SETC — ASSIGN CHARACTER VALUE TO SET SYMBOL 


The SETC statement assigns a character value to a set symbol. The assigned character value 
can be passed with the set symbol to another statement operand. The format of the SETC 


statement is: 


Set Symbol SETC Character term or 
arithmetic set expression 


The set symbol in the name field may not be generated as a result of substitution, that is, 
the name field must be explicitly coded. 
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The operand field may contain an arithmetic set expression or one of the following 
character terms: 


Term Example 
Symbolic parameter, including sublist &PARM2(3) 
and substring references 

SETC symbol, including substring &SET1 
references 

Substring of a character constant C‘ABCDE’(2,3) 
&SYSECT reference &SYSECT 
Character constant C’‘ABCD’ 
&SYSNDX reference &SYSNDX 


Only one operand is allowed. The maximum size of an assigned character value is 16 bytes. 
If a larger value appears, only the leftmost 16 bytes are assigned by the assembler. 


When &SYSNDX is used as a single character term, the value is a string of four characters, 
including leading zeros. If the operand specified is an arithmetic set expression, the 
arithmetic value is converted to a 16-bit constant. 


Examples of va/id SETC operands are: 


C’24BK’ 

&P 1 

&P1(2,4) 

&P1&P2(2,1) 

&SETC 

&SYSECT 

&SYSNDX 

(&SYSNDX+10-&P 1 (2,4)/2)*&P2(2) <EQ>C’FID’ 


Examples of invalid SETC operands are: 


X'124' String constant other than a character constant 
C’AB2’+4 Character constant used as arithmetic operand 
ALPHA Ordinary symbol 

L’ALPHA Length attribute 
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GBLA AND GBLC — GLOBAL ARITHMETIC AND CHARACTER SET SYMBOLS 


Local set symbols are made global (available outside the macro) by a GBLA or GBLC 
statement. The format of the GBLA or GBLC statement is: 


Operand 


Operation 


GBLA and 
GBLC 


1-35 set syrnbols, 
separated by commas 


Global statements must appear immediately after a prototype statement or after another 
global statement. Any number of continuation lines may be used. 


When a set symbol is declared global, its assigned value is available to statements in the main 
program, but not to other macro definitions. To be available to other macro definitions, the 
set symbols must also be declared global in those macro definitions. 

If set symbols have not been assigned values outside this macro definition or by a previous 
call to this definition, the global statement assigns an initial value of 0 to SETA symbols and 
a null character value to SETC symbols. If the set symbols have an assigned value, the global 
statements do not affect the value of the set symbols. 


ADO — ITERATIVE RETURN 


The ADO statement sets up a loop between the ADO statement and a subsequent statement 
identified in the ADO statement. The format of the ADO statement is: 


Operation Operand 


Sequence Positive arithmetic set 


symbol, set expression, sequence symbol 
symbol, or 
blank 


The sequence symbol in the name field can only be referenced by an AGO statement. 


The operand field must have two operands, separated by a comma. The first operand is a 
positive arithmetic set expression that indicates the number of iterations to be executed. 
The second operand is a sequence symbol that specifies the last statement of the loop. This 
sequence symbol must appear in the name field of a statement that follows, not precedes, 
the ADO statement. The sequence symbol cannot be in the name field of another ADO 
statement, a macro instruction, or an AGO statement. . 


If the set expression is equal to zero, control is transferred to the statement named in the 
second operand, and no intervening code is included. However, if the first operand is a 
positive number, the assembler subtracts 1 from the first operand and includes in the 
assembly all the code from the ADO statement to the statement named in the second 
operand. If the first operand is zero after the subtraction, the assembler does not return to 
the ADO statement but processes the next statement. If the first operand is not zero after 
the subtraction, the assembler again subtracts 1 from the first operand and repeats the loop. 
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Notice that when the first operand initially is zero, the jump is made to the statement 
named in the second operand. When the first operand is not initially zero, the indicated 
number of loops is performed and a jump is made to the first statement after the statement 
named in the second operand. !f the first operand is invalid, the value is set to 1. 


The name field may contain a sequence symbol, a set symbol, or a blank. If the name field 
contains a set symbol, the symbol is initially assigned a value of 1. For each iteration, this 
value increases by one while the first operand of ADO decreases by one. Thus, in the 
following example, after 10 iterations, the first operand is O and &COUNT is 10. 


OPERATION 


NAME OPERAND 


Ee) 394 5 6 7 8 10 11 12 13 14 15 16 17 19 20 21 22 23 24 25 26 27.2 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
—_—— i sa a ee 


4 1f,...END. .. deca Ah, Gait ates wc igh 2 ORS Ml aah. ted We A dee, Pte Sd, Sa eas, Cae 
Se re Coe ore | nee oe 


1 + r Cee eee 7 es er ee | re ' a E fp een bee Ft rae | 1. Bs Sse ak a L 


ao. ft 


The preceding statement performs a function equivalent to the following three statements. 
During the first iteration, &COUNT equals 1 and the first operand (10) is decreased by one. 
After 10 iterations, &COUNT equals 10 and the first operand equals 0. Control is then 
transferred to the first statement following the .END statement. 


OPERATION OPERAND 


aa hee Gd 8} 9 10 11 12 13 14 15 16 17 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


L 

S ETA 4 
a ro 4 os ocr ae Ava | pg ah a Sg a ecg sa. ig O4hs aes ee OW 
Baas H 0. Psy ate eee oF ae i SE Sh Ree Ngee ek, ak ade snk rae an oes, at eee i aa ae 
% 3 SET A oa a a fb Cu UNT. | 4 L. Anny tidy 2D ake ae a he ee RS Ee Oe ae oe 


The ADO statement can be used to include or exclude code from the assembly, depending 
upon the value of the first operand, as in the following example. If the variable symbol 
&LABEL is equal to YES, the first operand of the ADO statement is 1, and all intervening 
code is included in the assembly. If, however, &LABEL is not equal to YES, the first 
operand is zero and all intervening code is excluded. | 


NAME i OPERATION : OPERAND 
i278 34 5 6 ? 8} 9 | 10 11 12 13 14 15 16 17} 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
ee anne senate bmn reer mete hn a he Lede 


BEL <EQ>C' YES’ | 
x ee haifa Y Neer at 9.7 oP e Ais pi ES, a 8) 2 Se i ea 
Sapte ed il ae A a ee Sp hehe isa ill Gk fa cas le = 1 od 


= i L 
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hea So ee, Ske Sede Ss a a ee Sb oii ihe Pe ee 
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10-21 


NESTING OF ADO STATEMENTS 


As many as six ADO statements can occur within a primary ADO loop. Such nesting of 
ADO statements increases the total number of iterations in geometric progression. If five 
iterations are performed by an outer ADO loop, an inner ADO with five iterations increases 
the number of iterations to 25. An inner ADO statement cannot reference a statement 
outside one referenced by the outer ADO. 


The following statements produce a 5 x 5 matrix containing all products of the ordinary 
numbers 1 through 5. 


NAME OPERATION f OPERAND 
12.3.4 5 6.7 8[9| 10 11 1213 14 15 16 17] 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38.39 40.41 42 43.44 45 46 47 48 49 50 
i 
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eR OW AD O 

ee ee “) s@ CR Oe en ne Sennen Cannes enn eens tna Cen GS CONT CUE WEES OEE EES UENO UREDSGD WOUND CUES YOO SODSEID WORE EOD Sea Sen 

Ck wo 2a oon ‘ . COL. ROW “a Fae Caeeneie avg Lane WHRRY RES, Wee CNY COPPER EEO SS! LORESLy GEMM Vann QE CORD’ VCE! (aa Oe (rane COS 

{ee ge tare ee earay ears! Ore 2, ting bk! acd Sls eee Gull oa 41 rn : nn a a oe eo 44, | ean aera Lasera! ROEM 


During the first iteration of the outer ADO (named &COL), &COL equals 1 and &ROW 
increases by 1 with each iteration of the &ROW ADO statement until &ROW equals 5. 
During this first iteration, the statement .END WDD &COL *&ROW produces the values 1, 
2, 3, 4, and 5, as shown in the first column of values in this matrix. 


a 


First Pass of the Outer ADO 


&COL 
1 2 3 4 #45 


&ROW 


oP WON 
ohwWN = 


During the second iteration of the outer ADO, &COL equals 2 and & ROW again equals 1 
through 5. The second column of values is produced. 
Second Pass of the Outer ADO 


&COL 
3 4 5 


—_— 
NO 


&ROW 


OhAN = 
oRWN = 
- OM NM 
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This process continues until the outer ADO has performed five iterations, at which time the 
5 x 5 matrix contains the following values: 


&COL 


1 1 2 3 4 = &§ 
2 2 4 6 8. 10 
&ROW 3 3 6 9 12 15 
4 4 8 12 16 20 
5 5 10 15 20 25 


AGO — UNCONDITIONAL BRANCH 


The AGO statement transfers control to a statement named in its operand field. Statements 
between the AGO statement and the statement to which the jump is made are not included 
in the assembly. The format of the AGO statement is: 


Sequence 
symbol or 
blank 


Operation Operand 


AGO Sequence symbol 


The sequence symbol in the operand field must appear in the name field of a statement 
following, not preceding, the AGO statement. An AGO statement can transfer control out 
of an ADO loop. If an AGO statement transfers control into the range of an ADO loop, the 
source statements are processed as if no ADO loop exists. 


The AGO statement cannot jump into or out of a macro. An example of the AGO statement 
appears with the description of the ANOP statement in the following text. 

ANOP — LABEL DEFINITION 

The ANOP statement identifies a statement area to which a jump can be made. Because the 


ANOP statement is used for name field identification only, it has no operands and no 
operation is performed. The format of the ANOP statement is: 


Operation OCperand 


Sequence Not used — ignored 
symbol by the assembler 


If the programmer wants to use an ADO or AGO statement to branch to another statement, 
he must place a sequence symbol in the name field of the statement he wishes to branch to. 
However, if the name field already has an ordinary symbol or a variable symbol, a sequence 
symbol cannot be placed in the name field. To solve this problem, the programmer can place 
an ANOP statement before the statement he wishes to branch to, and branch to the ANOP 
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statement. This arrangement has the same effect as branching to the statement immediately 
after the ANOP statement. 


In Figure 10-10, the AGO statement performs an unconditional branch to the ANOP 
statement. All intervening code is excluded from the assembly. 


OPERATION OPERAND 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40 41 42 43.44 45 46 47 48 49 50 


I en nt Oe ee UO ee 


Figure 10-10. Example of the AGC Statement 


COUNT AND NUMBER ATTRIBUTES 


Count and number attributes are unique to macro instruction operands. These attributes can 
be referred to only in set expressions used as operands in conditional assembly statements 
within macro definitions. 


COUNT ATTRIBUTE 


The count attribute is a value equal to the number of characters in the macro instruction 
operand after substitution of variable symbols in the operand. All characters in the operand, 
including escape characters, are included in this count. If the operand is a sublist, the count 


attribute includes the embracing parentheses and the commas within the sublist. The count 
attribute of an omitted operand is zero. 


If an operand contains variable symbols, the characters that replace the variable symbol, 
rather than the variable symbols, determine the count attribute. 


The notation for the count attribute is K’ immediately followed by the symbolic parameter 
that corresponds to the operand. 
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The examples in Figure 10-11 illustrate the preceding rules. 


Macro Instruction Count 
Symbolic Parameter Operand Attribute Count Value 
&PAR ALPHA K'&PAR 5 
&PAR1 (JUNE JULY,AUGUST) K‘'&PAR1 18 
&PAR2 2(10,12) K’&PAR2 8 
&PAR3 C'ABH' #3’ | K'&PAR3 9 


Figure 10-11 Examples of the Count Attribute 


To reference the count attribute of a suboperand, K’ followed immediately by a subscripted 
symbolic parameter must be used, as in the example: K’&PAR(3). K’&PAR(3) refers to the 
count attribute of the third suboperand of the symbolic parameter &PAR. 


NUMBER ATTRIBUTE 


The number attribute is a value equal to the number of suboperands in an operand sublist. If 
the operand in the macro instruction is not a sublist, the value of the number attribute is 
one. The number attribute of an omitted operand is zero. 


The notation for the number attribute is N’ immediately followed by the symbolic 
parameter that corresponds to the operand, as in the example: N’&PAR. 


In the following macro instruction, the count attribute of the operand is 19, while the 
number attribute is 3: 


‘42.3 4 5 6 7 819] 10 11 1213 14 15 16 17| 18] 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 3839 40.41 42 43.44.45 46.47 48 49 50 
eee ES SS IAT CE ee wereisely elias Unoens CHOUEIT Dannii nnn nr ts nn VOD Dvn ro NO ey 


CINPUT.,.OUTPUT, EIST): oie aaa 


I ha haere rib: SR Be Sy te i es a 


OPERATION OPERAND 


i ke cen ed ee hee eed dl ls ae Lod Eee emer 4 1 oe | 4 a en Se os 44 4 1 


The following example has three operands, each with a number attribute of 1; their count 
attributes, however, are 5, 6; and 4, respectively. 


OPERATION OPERAND 


12345678 10 11 12 13 14 15 16 17} 18] 19. 20 21 22 23 24 25 26 27.28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 
solani i caer th nr basen els meneame ninenebeenrenlnrmterntntrtmichrreeretemweerehnimtehet 


INPUT. OUTPUT. LIST. POLES 


Bee le tf et et tk a tt td 


ane EE re eanee manne Cnn CnOEE he ea the ed ed bt a--41 44 1 
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li. CONTROL LANGUAGE STATEMENTS 


The Control Language for the assembler must provide the following four basic services: 


1, Call the assembler into execution 

2. Specify the assembly options 

3: Define source input, object output, source output, and macro library 
input files 

4, Obtain the source program from the card reader, library member, or 


spooled input 


The Control Language statements for the assembler are explained below. For the exact 
format of the statements, consult the MRX/OS Control Language Services, Extended 
Reference manual. 


Control 
Language 
Statement Parameter Description 
//EXEC PGM= ASM | Calis the assembler into execution. 
//PAR Keyword options Specifies the assembly options in 
free form. 
//PAR IMEM= Input-member-name Specifies the name of the input source 


module on the library. If omitted, the 
source is assumed to be a non- 
partitioned sequential data file (such 
as a spooled input file). 


Control 

Language sie 

Statement Parameter Description ) 

Ps 

Output-member-name Specifies the name of the relocatable 
object module on the library. If 
omitted and OBJECT=YES or COND, 


the assembly is aborted. 


//PAR OMEM1= 


//PAR OMEM2= Punch-indicator 1-10 alphabetic characters to indicate 
that PUNCH output is expected. If 


omitted, no PUNCH output is produced. 


//PAR MAXSIZ= 1-5 decimal digits Specifies the approximate number of 
source lines generated in the program. 
If omitted, the default value is the 


SYSGEN parameter, usually 1000. 


//PAR LIST= YES Specifies whether the source program is 
NO to be listed: 
YES List source program 
NO Omit listing 
If omitted, the default parameter is 
YES. 
//PAR XREF= YES Specifies whether a cross-reference list 
NO is to be generated: 


YES Generate cross-reference list 
NO Omit cross reference list 


//PAR ERROR= YES Specifies whether warning errors are to 
NO be listed: 
YES List warning errors 
NO Omit listing 
If omitted, the default parameter is YES. 
Fatal errors are always listed. 
//PAR OBJECT= YES | Specifies under what conditions a relocatable 
NO object module is to be generated: 
COND] 


YES Module is generated unconditionally 
NO Module is not generated 
COND Module is generated if no fatal 

error occurred 


If omitted, the default parameter is YES. 
If the option, YES or COND, is selected, 
the OMEM1 option must be specified. 
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Control 


Language . 

Statement Parameter Description 

//DEF ID= File identifier Defines the source input, object output, 
source output, list output, and macro 
library input files. 

//DEF ID= INPUT _Source input file =. 

//DEF ID= ‘< OUTPUT! » Relocatable output file: must bé 252 “12 

ee bytes, blocked_1.. The file must be a 
— partitioned data file. The device must 

be disc. CSD=YES 

//DEF ID= OUTPUT2 Source punch file identifier: must be 
80 bytes, blocked 1. The file must be 
a non-partitioned sequential data set. 
CSD=YES 

//DEF ID= LIST List output file: must be 132 bytes, 
blocked 1. The file must be a sequential 
data set. CSD=NO. The file is written 
with the first character being a ‘‘native” 
mode control character for a printer. 

//DEF ID= MACLIB Macro library input: the file must be a 


partitioned data set, CSD format, 80 
byte records, ee tL: 


1/ 


\CL:IB is.-not.spe sified, the default file name is $SYSMACLIB. The INPUT and LIST. 
<i must_always be defined} the OUTPUT1 and OUTPUT2 files are optional. DEFINE 
tatements may also include keyword parameters to identify the file name or the device 
with which the file is associated. 


If the source program is to be read from the card reader, the source program card deck must 
be preceded by a //DATA FIL=SYSCRD statement and terminated by a /* card. 
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The cards in Figure 11-1 illustrate the Control Language statements to specify: 


® Source input from cards 
® Relocatable output to a specified library member 
e List output to printer 
e Cross-reference output 
i* 
Source 
Program 


//DATA FIL=SYSCRD 
//PAR OMEM1=PRG2,XREF=YES 
//DEF 1D=OUTPUT1,FIL=$LIB 
//DEF ID=LIST,DEV=PRINTER 
//DEF ID=INPUT,DEV=SYSCRD 


H/EXEC PGM=ASM 


Figure 11-1. Example of Cx ( Language Statements 
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The cards in Figure 11-2 illustrate the Control Language statements to specify: 


e Source input from spooled input file 

e Relocatable output to a specified library member 
e List output to printer 

© Cross-reference sitet 


Source 
Program 


//DATA FIL=name 


/(PAR OMEM1=PRG2,XREF#¥YES 


//DEF 1D=OUTPUT1,FIL=$LIB 
//DEF ID=LIST,DEV=PRINTER 


//DEF ID=INPUT,FIL=name 


//EXEC PGM=ASM 


Figure 11-2. Example of Controt Language Statements 


The cards in Figure 11-3 illustrate the Control Language statements to specify: 


® Source input from a library file 

e Relocatable output to a specified library member 
e List output to printer 

e Cross-reference output 


//PAR OMEM1=PRG2,XREF=VES 
//DEF ID=OUTPUT1,FIL=$LIB 
//OEF 1D=LIST,DEV=PRINTER 
//DEF ID=INPUT,FIL=MYSOURCEFIL STA=(P,!) 


//EXEC PGM=ASM 


Figure 11-3. Example of Control Language Statements 


To place the intermediate files on non-shared resource discs, any or all of the cards in Figure 
11-4 may be included in the job control stream: 


//DEF ID=MRELFIL,FIL=DUMMY ,VOL=userpack 
//DEF ID=MRMRGFIL,FIL=DUMMY ,VOL=userpack 
//DEF ID=MRSRTFIL,FIL=DUMMY ,VOL=userpack 


//DEF ID=MRTEXT01,FIL=DUMMY ,VOL=userpack 


//DEF ID=MRVIRTAL,FIL=DUMMY ,VOL=userpack 


//DEF 1D=MRXRFFIL,FIL=DUMMY ,VOL=userpack 


Figure 11-4. Placing Files on Disk — Example 
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The file MRTEXTO1 has the highest traffic and would be the best candidate for 
performance enhancement. The file MRXRFFIL is used in macro generation and cross 
reference generation programs. The files MRSRTFIL and MRMRGFIL are used for cross 
reference. The file MRVIRTAL is used primarily for symbol table overflow. The file 
MRELFIL is used for error output. 


A. EBCDIC REPRESENTATION 


EBCDIC EBCDIC 


Graphic Card Code Graphic Card Code 


0-7-8-9 
12-11-0-1-8-9 


12-0-1-8-9 
12-1-9 
12-2-9 
12-3-9 
12-4-9 
12-5-9 
12-6-9 
12-7-9 
12-8-9 
12-1-8-9 
12-2-8-9 
12-3-8-9 
12-4-8-9 
12-5-8-9 
12-6-8-9 
12-7-8-9 
12-11-1-8-9 
11-1-9 
DC2 11-2-9 
DC3 11-3-9 
RES 11-4-9 
NL 11-5-9 
BS 11-6-9 
IL 11-7-9 
11-8-9 
EM 11-1-8-9 
CC 11-2-8-9 
11-3-8-9 
IFS 11-4-8-9 
IGS 11-5-8-9 
IRS 11-6-8-9 
ITB(IUS) 11-7-8-9 
DS 11-0-1-8-9 
SOS 0-1-9 
FS 0-2-9 
0-3-9 
BYP 0-4-9 
LF 0-5-9 
EOB/ETB 0-6-9 
ESC/PRE 0-7-9 
0-8-9 
0-1-8-9 
0-2-8-9 
0-3-8-9 
0-4-8-9 
0-5-8-9 
0-6-8:9 


1-8-9 
2-8-9 
3-8-9 
4-8-9 
5-8-9 
6-8-9 
7-8-9 

No punches 
12-0-1-9 
12-0-2-9 
12-0-3-9 
12-0-4-9 
12-0-5-9 
12-0-6-9 
12-0-7-9 
12-0-8-9 — 
12-1-8 
12-2-8 
12-3-8 
12-4-8 
12-5-8 
12-6-8 
12-7-8 

12 
12-11-1-9 
12-11-2-9 
12-11-3-9 
12-11-4-9 
12-11-5-9 
12-11-6-9 
12-11-7-9 
12-11-8-9 
11-1-8 
11-2-8 
11-3-8 
11-4-8 
11-5-8 


A-1 


EBCDIC 


Hex 
Code 


a 
b 
c 
d 
e 
f 
9g 
h 
i 


Card Code 


11-6-8 
11-7-8 

11 

0-1 

11-0-2-9 
11-0-3-9 
11-0-4-9 
11-0-5-9 
11-0-6-9 
11-0-7-9 
11-0-8-9 
0-1-8 

12-11 

0-3-8 

0-4-8 

0-5-8 

0-6-8 

0-7-8 
12-11-0 
12-11-0-1-9 
12-11-0-2-9 
12-11-0-3-9 
12-11-0-4-9 
12-11-0-5-9 
12-11-0-6-9 
12-11-0-7-9 
12-11-0-8-9 
1-8 

2-8 

3-8 

4-8 

5-8 

6-8 

7-8 
12-0-1-8 
12-0-1 
12-0-2 
12-0-3 
12-0-4 
12-0-5 
12-0-6 
12-0-7 
12-0-8 
12-0-9 
12-0-2-8 
12-0-3-8 
12-0-4-8 
12-0-5-8 
12-0-6-8 
12-0-7-8 
12-11-1-8 
12-11-1 
12-11-2 
12-11-3 
12-11-4 


A-2 


B7 


EBCDIC 


Ne xs <c ctw 


-~TraTmT?DmooOdADW YD 


12-11-5 
12-11-6 
12-11-7 
12-11-8 
12-11-9 
12-11-2-8 
12-11-3-8 
12-11-4-8 
12-11-5-8 
12-11-6-8 
12-11-7-8 
11-0-1-8 
11-0-1 
11-0-2 
11-0-3 
11-0-4 
11-0-5 
11-0-6 
11-0-7 
11-0-8 
11-0-9 
11-0-2-8 
11-0-3-8 
11-0-4-8 
11-0-5-8 
11-0-6-8 
11-0-7-8 
12-11-0-1-8 
12-11-0-1 
12-11-0-2 
12-11-0-3 
12-11-0-4 
12-11-0-5 
12-11-0-6 
12-11-0-7 
12-11-0-8 
12-11-0-9 
12-11-0-2-8 
12-11-0-3-8 
12-11-0-4-8 
12-11-0-5-8 
12-11-0-6-8 
12-11-0-7-8 
12-0 

12-1 

12-2 

12-3 

12-4 

12-5 

12-6 

12-7 

12-8 

12-9 
12-0-2-8-9 
12-0-3-8-9 


EBCDIC EBCDIC 


Graphic Card Code Graphic Card Code 


12-0-4-8-9 

12-0-5-8-9 

12-0-6-8-9 

12-0-7-8-9 

11-0 11-0-2-8-9 
11-1 11-0-3-8-9 
11-2 11-0-4-8-9 
11-3 11-0-5-8-9 
11-4 11-0-6-8-9 
11-5 11-0-7-8-9 
11-6 

11-7 

11-8 

11-9 
12-11-2-8-9 
12-11-3-8-9 
12-11-4-8-9 
12-11-5-8-9 
12-11-6-8-9 
12-11-7-8-9 
0-2-8 12-11-0-2-8-9 
11-0-1-9 12-11-0-3-8-9 
0-2 12-11-0-4-8-9 
0-3 12-11-0-5-8-9 
0-4 12-11-0-6-8-9 
0-5 12-11-0-7-8-9 


DOVOZB2°rAC 
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B. OBJECT FORMATS OF MACHINE INSTRUCTIONS 


The notation used to describe the source and object format in Appendixes A and B is as follows (a = 
absolute, r = relocatable expression). 


Op Code 
R 
E 


Hexadecimal 00-F F 

General register, 0-7. (a) 

Extended register, 0-15. (a) 

Memory address, 0-65,535. (a or r) 

Immediate value-arithmetic value, shift count, skip count, or bit number. (a) 
Field length, 0-255 (for MOVL, 0-65,535). (a) 

Parentheses enclose index registers and field lengths, both of which are optional. 


A bullet following an instruction name indicates the operands are byte-addressable; other 
operands are word-addressable only. 


Bits 8 and 12 of the object instructions are used in almost every instruction to convey information to the 
computer concerning that instruction. If these bits are not interpreted in any way, they are shaded; 
otherwise, the following symbols are used to define bits 8 and 12. 


Indirect addressing indicator; for direct addressing i=O, for indirect addressing i=1. Indirect 
addressing is indicated by the programmer. 


A sub-function indicator; indicates a function that the operation code alone cannot do. 
These function bits.are set by the assembler. 


If bit 8 or 12 must be a 1 or a O for a particular instruction, the bit will be shown as a 1 or 
0. These bits are set by the assembler; if the wrong bit state appears in the object instruction, 
a no-operation occurs. 


TWO BYTE INSTRUCTIONS 


Op Mnemonic Word/Operand 

Code Code Description ___ Format 

22 ADDR Add Register-Register 

23 SUBR Subtract Register-Register 

29 DIVR Divide Register-Register 

28 MPYR Multiply Register-Register 

25 ANDR Logical Product Register-Register 

26 EORR Exclusive OR Register-Register 0 Cae M1 12 13 15 


27 {ORR Inclusive OR Register-Register 
21 CMPR | Compare Register-Register Op Code 
20 MOVR 


Move Register-Register 


24 INVR Inverse Move Register-Register Source Operands: @R1,@R5 
6F ROFR Reverse Off-Bit 
6D RONR Reverse On-Bit 
6E TOFR Test for Off-Bit 
6C TONR Test for On-Bit 
32 ADDI Add Immediate 
33 SUBI Subtract Immediate 
39 DIVI Divide Immediate 
38 MPYI Multiply Immediate 
35 ANDI Logical Product Immediate 0 7 8 1112 13 15 
36 EORI Exclusive OR Immediate 
37 IORI Inclusive OR Immediate . Op Code po fe om 
31 CMPI Compare Immediate 
30 LODI Load Immediate Source Operands: 1,,@R9 
34 INVI Inverse Move Immediate 
F5 INP Input from I/O Register 
F6 OUT Output to 1/O Register 
0 7 8 9 11 12 13 15 


81 INT Convert float to fixed 
81 INTT Convert float to fixed Op Code f 


Source Operands: @R41,Ro 


two-word 


8 9 
82 FLT Convert fixed to float 
82 FLTT Convert fixed to float 
two-word 


Source Operands: @R, 
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Op 
Code 


5F 


4F 


5C 


4C 


5D 


4D 


5E 


4E 


47 


46 


43 


42 


45 


44 


41 


40 


3F 


2F 


3C 


2C 


3D 


2D 


3E 


2E 


F2 
Fi 


Mnemonic 


__ Code 


ARDI 
ARSI 
LLDI 
LLS! 
LRDI 
LRSI 
RLDI 
RLSI 
SRMB 
SRMF 
SRNB 
SRNF 
SRPB 
SRPF 
SRZB 


SRZF 


ARDR 
ARSR 
LLDR 
LLSR 
LRDR 
LRSR 
RLDR 
RLSR 


DIO 
slO 


Description 


Arithm. Right Double Shift 
Immediate 

Arithm. Right Single Shift 
Immediate 

Logical Left Double Shift 
immediate 

Logical Left Single Shift 
Immediate 

Logical Right Double Shift 
Immediate 

Logical Right Single Shift 
Immediate 

Rotating left Double Shift 
Immediate 

Rotating left Single Shift 
immediate 

Skip if Register is Minus 
Backward 

Skip if Register is Minus 
Forward 

Skip if Register Not Zero 
Backward 

Skip if Register Not Zero 
Forward 

Skip if Register is Plus 
Backward 

Skip if Register is Plus 
Forward 

Skip if Register is Zero 
Backward 

Skip if Register is Zero 
Forward 


Arithm. Right Double Shift 
By Register 

Arith. Right Single Shift 
By Register 

Logical Left Double Shift 
By Register 

Logical Left Single Shift 
By Register 

Logical Right Double Shift 
By Register 

Logical Right Single Shift 
By Register 

Rotating Left Double Shift 
By Register 

Rotating Left Single Shift 
By Register 

Disk 1/O 

System 1/O 


Word/Operand 
Format 


11.12 13 15 


Source Operands: 14,Ro 


0 7 8 9 


11.12 13 15 


Source Operands: @Ry,R9 
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Op 
Code 


EB 
2B 


BB 
BA 


4B 
49 
AA 


48 


13 


10 
10 
14 
14 
15 


15 


12 
11 


Mnemonic 
Code 


BR 
CLDR 


SB 
SF 


SCFB 


SCFF 


SCTB 


SCTF 


SR 


RBA 
SBA 
RCN 
SCN 
RPM 


SPM 


CTB 
TST 


Word/Operands 


Description Format 


Branch to Address in Register 
Condition Register Load 


Source Operands: @R, 


0 7 8 15 


Skip Unconditional Backward Op Cod 
Skip Unconditional Forward ac setares 


Source Operands: |, 


Skip on Condition Register 
False - Back 


Skip on Condition Register 0 8 yee: 1S 
False - Forward 
Skip on Condition Register Op Code rake 
True - Back 
Skip on Condition Register Source Operands: 14,19 
True - Forward 
0 7 8 9 15 


Source Operand: @1, 


Reset Busy/Active Register 


Set Busy/Active Register 0 789 11 12 13 15 
Reset Control Register 

Reset Privileged Mode 

Register 


Ss O ds: @R4,I 1,,! 
Set Privileged Mode Register a a aah 1612 OF N42 


0 7 8 11 12 15 


Ciear Tie-Breaker Register 
Test and Set Tie-Breaker 
Register 


Source Operand: |, 


Op Mnemonic Word/Operand 


Code Code Description Format 
0 7 8 9 11 12 13 15 
EF BCM Branch to Control Memory 
F4 WRC Communications Output 
Command | 


Source Operands: R4,R9 


0 7 8 11 12 13 15 


FO RDX Read Extended Register 
FO WRX Write Extended Register Op Code f 


Source Operands: E1,R5 


0 

F3 RDC Communications I/O 
. Op Code 

80 NEGF Negate Floating Point 

Source Operands: none 

0 7 8 11 12 13 15 
2A CSTR Condition Register Store : 
3A PSTR Program Address Store 


Source Operand: @R4 


FOUR BYTE INSTRUCTIONS 


Op 


Code 


A2 
72 

A3 
73 

AQ 
A8 
Ad 
A6 
A7 
F9 
Al 

71 

AO 
F7 

70 

FA 
F8 
FB 
A4 
E4 
E5 
E1 

EO 
E6 
E7 
EA 
EE 


Mnemonic 
Code 


ADD 
ADDT 
SUB 
SUBT 
DIV 
MPY 
AND 
EOR 
IOR 
CBY 
CMP 
CMPT 
LOD 
LODB 
LODT 
STO 
STOB 
STOT 
INV 
BA1 
BA2 
BRN 
BRZ 
BS1 
BS2 
BSR 
NOP 


ADDD 
SUBD 
DIVD 
MPYD 
ANDD 
EORD 
IORD 
CMPD 
LODD 
INVD 


LODF 
ADDF 
SUBF 
MPYF 
DIVF 


Description 


Add 

Add Two-Word 

Subtract 

Subtract Two-Word 

Divide 

Multiply 

Logical Product 

Exclusive OR 

Inclusive OR 

Compare Byte e 

Compare 

Compare Two-Word 

Load, Memory-Register 

Load Byte Memory-Register e 
Load Two-Word 

Store Register-Memory 

Store Byte Register-Memory e 
Store Two-Word 

Inverse Move Memory-Register 
Branch Add 1 

Branch Add 2 

Branch if Register is Not Zero 
Branch if Register is Zero 
Branch Subtract 1 

Branch Subtract 2 

Branch and Save Return 

No Operation 


Add Direct 

Subtract Direct 

Divide Direct 

Multiply Direct 
Logical Product Direct 
Exclusive OR Direct 
Inclusive OR Direct 
Compare Direct 

Load Direct 

Inverse Move Direct 


Load floating point 
Add floating point 
Subtract floating point 
Multiply floating point 
Divide floating point 


Word/Operand 
Format 


7 8 9 11. 12 13 


a 


Source Operands: @M4(R4),@Ro 


Source Operands: 14(R4),@Ro 


0 7 8 9 11 12 13 15 


Op Code 


Source Operands: @M4(R4),R9 
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Op 
Code 


EQ 
E8 


E2 
E3 


AA 
AA 


AB 
AB 


BF 
BD 
BC 
BE 


ED 
EC 
87 
8A 


Mnemonic 


Code 


BCF 


BCT 


BOF 
BON 


CVB 
CVBT 


CVD 
CVDT | 


IBIT 

RBIT 
SBIT 
TBIT 


RAR 
WAR 
RSAR 
SAR 
RRO 
WRO 


Word/Operand 


Description Format 
Branch on Condition 0 7 8 9 11.12 15 


Register - False 
Branch on Condition 

Register - True 
Branch if Bit is Off 
Branch if Bit is On 


Source Operands: @M4(R4),I9 


Convert to Binary e 0 
Convert to Binary 
Two-Word o 
Convert to Decimal e 
Convert to Decimal 


Op Code 


Two-Word e 
Source Operands: @M,(R4),Ro 
Invert Bit e 0 7 8 9 11 12 13 15 
Reset Bit @ 
Set Bit e 
Test Bit @ 
Source Operands: @M4(R4),l9 
Branch-Post Indexing 0 7 8 9 11 12 15 


Branch-Pre Indexing 


Compare floating point 
Store floating point 


Source Operands: 


Read Any Register 0 
Write Any Register 
Restore All Registers 
Save All Registers 
Read Register Options 
Write Register Options 


Op Code 


Source Operands: 14(R47),@R2 


SIX BYTE INSTRUCTIONS 


Op Mnemonic Word/Operand 
Code Code Description Format 
62 ADDM Add Memory-Memory 
63 SUBM Subtract Memory-Memory 
69 DIVM Divide Memory-Memory 
68 MPYM Multiply Memory-Memory 
65 ANDM Logical Product Memory- 0 

Memory 
66 EORM Exclusive OR Memory- 

Memory 
67 IORM Inclusive OR Memory- 

Memory 
6B CBYM Compare Byte Memory- 

Memory e 
61 CMPM Compare Memory-Memory Source Operands: @M4(R1),@M9(R>) 
6A MOVB Move Byte Memory-Memory e 
60 MOVM Move Word Memory-Memory 
64 INVM Inverse Move Memory- 

Memory 

0 7 11 12 13 15 

3B SHFK Shift Packed Decimal e@ 


Source Operands: M4(L4,R4),lo(Ro) 


EIGHT BYTE INSTRUCTIONS 


Op 
Code 


5A 


Mnemonic 
Code 


ADDK 
SUBK 
CMPK 
CMPX 
MOVX 
PAKX 
UNPX 
ZADK 
EDTX 


DIVK 
MPYK 


TRNX 


MOVL 


Word/Operand 


Description Format 


Add Packed Decimal e 

Subtract Packed Decimal e 

Compare Packed Decimal e 

Compare Characters e@ Op Code 

Move Characters @ 

Pack e 

Unpack e 

Zero and Add Decimal e 

Packed Decimal/Alpha 
Edit e 

Divide Packed Decimal e Source Operands: M4(L4,R4),Mo(Lo,R9) 

Multiply Packed Decimal e 


Translate e 


Source Operands: M4(R4),M9(L9,R9) 


Move Long e 


Source Operands: M4(L4,R7),Mo(R9) 


C. ALPHABETICAL LIST OF MNEMONICS 


This appendix lists all machine mnemonic codes and extended mnemonic codes in alphabetical order. Also 
included are the hexadecimal function codes, the instruction size in bytes, and the configuration of the 
source operand. An asterisk in the function code column indicates an extended mnemonic code. The 
symbols used in the operand configuration are the same as in the preceding lists. 


Mnemonic Operation Instruction 

Code _ Code ___ Size (Bytes) Operand Configuration 
ADD A2 4 @M4(R4),@Ro 
ADDD B2 4 14(R4),@Ro 

ADDF 86 4 @M4(Rq),Ro 
ADDI 32 | 2 1,,@Ro 

ADDK 52 8 M4(L4,R4),Mp(Lo,R9) 
ADDM 62 | 6 @M4(R4),@Mo(Ro) 
ADDR 22 2 @R1,@R5 

ADDT 72 4 @M4(R4),@Rz 
AND A5 4 @M4(R4),@R5 
ANDD B5 4 1,(R4),@Ro 

ANDI 35 2 11,@R9 

ANDM 65 6  @M4(Rq),@Mo(Ro) 
ANDR 25 2 @R1,@Rz 

ARDI 5F 2 14,R9 

ARDR 3F 2 @R,,Ro 

ARSI 4F 2 1yRo 

ARSR 2F 2 @R1,Ro 

B ED 4 @M4(R4) 

BAI E4 4 @M4(R4),@Rz 
BA2 E5 4 @M4(R4),@Rz 
BBR . @M4(R4) 

BBS ae @M,(R}) 

BCF EQ 4 @M4(Rq),I9 

BCH EC 4 @M4(Ry) 

BCM EF 2 Ry,Ro 

BCT E8 4 @M, (R4),l9 

BCY . @M4(Rq) 

BEQ : @M (Ry) 

BGE . @M4(R4) 

BGT : @M4(R4) 

BID . @M4(Rq) 

BKM * @M4(R4) 

BKP " @M4(R4) 

BKZ @M,(R4) 

BLE ' | @M4(R4) 

BLEQ . @M4(Rq) 

BLGE @M,(R4) 
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Mnemonic Operation Instruction 


Code Code Size (Bytes) Operand Configuration 
BLGT " @M4(R4) 

BLLE i @M4(R}) 

BLLT . @M 4(R4) 

BLNE i @M,(R4) 

BLT 4 : @M4(R) 

BNC i @M4(R4) 

BNE > @M4(R4) 

BNI . @M4(R4) 

BNV . @M4(R4) 

BOF E2 4 @M4(R4),19 

BON E3 4 @M4(R4),I9 

BOV a @M4(R4) 

BR EB 2 @R, 

BRN E1 4 @M4(R7),@Ro 
BRZ EO 4 @M4(R7),@R2 

BS1 E6 4 @M4(R1),@Ro 

BS2 E7 4 @M4(R1),@Ro 
BSR EA 4 @M4(R7),@Ro 
CBY F9 4 @M4(R7),@Ro 
CBYM 6B 6 @M4(R4),@M(R9) 
CLDR 2B 2 @R, 

CMP Al 4 @M4(R4),@Ro 
CMPD B1 4 14(R4),@Ro 

CMPF 87 4 @M4 (Ry) 

CMPI 31 2 14,@R5 

CMPK 51 8 M4(L4,R4),.My(Lo,R9) 
CMPM 61 6 @M4(R7),@Mo(R>) 
CMPR 21 2 @R1,@Ro 

CMPT 71 4 @M4(R1),@Ro 
CMPX 55 8 My(L4,R4),Mo(Lo,R2) 
CSTR 2A 2 @R, 

CTB 12 2 1 

CVB AA 4 @M4(R4),Ro 
CVBT . AA 4 @M4(R4),Ro 

CVD AB 4 @M4(R4),Ro 
CVDT AB 4 @M4(R4),Ro 

DIO F2 2 @R1,Ro 

DIV AQ 4 @M4(R4),@R2 
DIVD B9 4 14(R4),@R9 

DIVF 89 4 @M4(R4),Ro 

DIVI 39 2 14,@R95 


Mnemonic Operation Instruction 


Code . __Code Size (Bytes) Operand Configuration 
DIVK 7C 8 M4(L4,R7),Mo(Lo,R9) 
DIVM 69 6 @M4(R7),@M9(R9) 
DIVR 29 2 @R1,@R9 

EDTX 57 8 M4(L4,R4),Mo(Lo,R9) 
EOR A6 4 @M4(R4),@Ro 
EORD BG 4 14(R7),@Ro 

EORI 36 2 14,@Ro 

EORM 66 6 @M4(R1),@M9(Ro) 
EORR 26 2 @R1,@RQ 
FLT/FLTT 82 2 @R, 

IBIT BF 4 @M4(R4),19 

INP F5 2 14,@R9 

INT/INTT 81 2 @R71,R9 

INV | A4 4 @M4(R1),@Ro 
INVD B4 4 14(R4),@Ro 

INVI 34 2 14,@R9 

INVM 64 . 6 @M1(R7),@Mo(R>) 
INVR 24 2 . @R1,@Ro 

IOR A7 4 @M4(R7),@R2 
IORD B7 4 14(R4),@Ro 

IORI 37 2 14,,@Ro 

iORM 67 6 @M4(R7),@Mo(Ro) 
IORR 27 2 @R7,@Ro 

LLDI 5C 2 14,R9 

LLDR 3C 2 @R1,Ro 

LLSI 4C 2 14,R9 

LLSR 2C 2 @R4,R9 

LOD AO 4 @M4(R7),@Ro 
LODB F7 4 @M4(R1),@Ro 
LODD BO 4 14(R4),@Ro 

LODF 84 4 @M4(R4),Ro 

LODI 30 2 14,@Ro 

LODT 70 4 @M4(R4),@Ro 
LRDI 5D 2 14,Ro 

LRDR — 3D 2 @R4,Ro 

LRSI 4D 2 14,Ro 

LRSR 2D 2 @R1,R9 

MOVB 6A 6 @M4(R7),@M9(R9) 
MOVL 5A 8 M4(L4,R4),Mo(Ro) 
MOVM 60 6 @M4(R4),@M(R9) 
MOVR 20 2 @R1,@Ro 


Mnemonic Operation instruction 


Code Code Size (Bytes) Operand Configuration 
MOVX 5A 8 M4 (L4,R4),Mo(L2,R9) 
MPY A8 4 @M4(R4),@Ro 

MPYD BS 4 14(R4),@Ro 

MPYF 88 4 @M4(R4),.Ro 

MPY| 38 2 11,@Ro 

MPYK 5B 8 M4(L4,R7),Mo(Lo,R9) 
MPYM 68 6 @M4(R7),@My(Ro) 
MPYR 28 2 @R1,@R5 

NEGF 80 2 blank 

NOP EE 4 blank or @M4(R4),@Ro 
OUT F6 2 11,@Ro 

PAKX 58 8 M4(Ly,R4),Mo(Lo,R9) 
PSTR 3A 2 @R, 

RAR FE 4 M4(R4),@R2 

RBA 10 2 @Rq 19 or Iyly 

RBIT BD 4 @M4(R4),10 

RCN 14 2 @Rj4,I9 or 4,19 

RDC F3 2 

RDX FO 2 E1,Ro 

RLDI 5E 2 11Ro 

RLDR 3E 2 @R1,Ro 

RLSI 4E 2 11.Ro 

RLSR 2E 2 @Ry,Ro 

ROFR 6F 2 @R1,@Ro 

RONR 6D 2 @R1,@R> 

RPM 15 2 @Rj,19 or 14,19 

RRO FD 4 M4(R4),@R2 

RSAR FF 4 M4(R4),@R2 

S . M, or ly 

SAR FF 4 M4(R4),@R2 

SB BB 2 F 

SBA 10 2 @Rq,N9 oF IyI9 

SBIT BC 4 @M4(R4),19 

SBR 7 My or ly 

SBS . M, or 1y 

SCF ‘ My,lp or 14,19 

SCFB 4B 2 Into 

SCFF 49 2 Ido 

SCN 14 2 @R}1,19 or 14,19 

SCT : My,Ip oF Iy,15 

SCTB 4A 2 Iqlg 
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Mnemonic Operation Instruction 


Code _ Code _ Size (Bytes) Operand Configuration 
SCTF 48 2 Iyl5 

SCY * M, or Iy 

SEQ + My or ty 

SF BA 2 ly 

SGE i My or ty 

SGT a My or |, 
SHFK 3B 6 M4(L4,R4),1o(Ro) 
SID - M, or |, 

slo F1 2 @R,,Ro 

SKM : M, or ty 

SKP . My or ly 

SKZ is My or ly 

SLE : My, or ly 
SLEQ e M4 or 1, 

SLGE ” M, or ly 

SLGT - My or |y 

SLLE - M, orl, 

SLLT r My or |y 

SLNE : M1 or 1 

SLT * M, or |y 

SNC a M, or |y 

SNE 7 M, or |y 

SNI . ; My or 1y 

SNV : My or |4 

SOV 7 My or ly 

SPM 15 2 @Ry,19 or 14,15 
SR 13 2 @l, 

SRM : My,R9 or 14,R9 
SRMB 47 2 14,Ro 

SRMF 46 2 11,Ro 

SRN = M7,R9 or 14,19 
SRNB 43 2 14,19 

SRNF 42 2 14,Ro 

SRP = My,R9 or 14,19 
SRPB 45 2 1,Ro 

SRPF 44 2 11,Ro 

SRZ . M4,R9 or I4,l9 
SRZB 41 2 14,R9 

SRZF 40 2 11,Ro 

STO FA 4 @M4(R4),@R> 
STOB F8 4 @M4(R4),@Rz 


Mnemonic Operation Instruction 


Code Code Size (Bytes) Operand Configuration 
STOF 8A 4 @M,(R4) 

STOT FB 4 @M,(R7),@Ro 

SUB A3 4 @M4(R4),@Ro 

SUBD B3 4 14(R7),@R2 

SUBF 85 4 @M4(R4),Ro 

SUBI 33 2 14,@Ro 

SUBK 53 8 M4(L4,R4),Mo(Lo,Ro) 
SUBM 63 6 @M4(R4),@Mo(R9) 
SUBR 23 2 @R1,@R9 

SUBT 73 4 @M4(R1),ERo 

TBIT BE 4 @M4(R4),19 

TOFR 6E 2 @R1,@R9o 

TONR 6C 2 @R1,@R2 

TRNX 56 8 M4(R4),Mo(L9,R9) 
TST 11 2 ly 

UNPX 59 8 M4(L4,R4),Mo(Lo,R9) 
WAR FE 4 M4(R4),@R2 

WRC F4 2 Ry,R9 

WRO FD 4 M4(R7),@R9 

WRX FO 2 E,,R9 

ZADK 50 8 M4(L4,R4),Mo(Lo,R9) 
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D. HEX CODE TO MNEMONIC CODE 


SBA/RBA MOVB 
CBYM 
TONR 
RONR SF 
SCN/RCN TOFR SB 
SPM/RPM ROFR SBIT 
MOVR . LODT RBIT 
CMPR CMPT TBIT 
ADDR ADDT IBIT 
SUBR SUBT BRZ 
INVR DIVK BRN 
ANDR NEGF BOF 
EORR INT/INTT BON 
IORR FLT/FLTT BA1 
MPYR LODF BA2 
DIVR SUBF BS1 
CSTR ADDF BS2 
CLDR CMPF BCT 
LLSR MPYF BCF 
LRSR DIVF BSR 
-RLSR STOF BR 
ARSR LOD BCH 
LODI CMP B 
CMPI ADD NOP 
ADDI SUB BCM 
SUBI INV RDX/WRX 
INVI AND SlO 
ANDI EOR DIO 
EORI 1IOR RDC 
IORI MPY WRC 
MPY1 DIV INP 
DIVI CVB/CVBT OUT 
PSTR CVD/CVDT LODB 
SHFK LODD STOB 
LLDR CMPD CBY 
LRDR ADDD STO 
RLDR SUBD STOT 
ARDR INVD RRO/WRO 
SRZF ANDD RAR/WAR 
SRZB EORD SAR/RSAR 
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E. SUMMARY OF ASSEMBLER STATEMENTS 


Name Operation Operand 
Sequence symbol, set symbol, ADO Arithmetic set expression, 
or blank sequence symbol 


Sequence symbol or blank AGO Sequence symbol 


Symbol or blank | ALIGN ~ Absolute, resolved arithmetic 
expression 


Sequence symbol ANOP Not used — ignored by the 
assembler 


Symbol or blank BDD One or more operands 
separated by commas 


Symbol or blank BRS Absolute, arithmetic 
expression 


Symbol or blank COM Not used — ignored by the 
assembler | 


Symbol or blank CSECT Not used — ignored by the 
assembler 


Sequence symbol or blank EJECT Not used — ignored by the 
assembler 


Blank END Ordinary symbol or blank 


Sequence symbol or blank ENTRY One or more relocatable symbols 
separated by a comma 


Ordinary or variable symbol EQU Expression 


Sequence symbol or blank EXTRN One or more relocatable symbols 
separated by a comma 


Ordinary symbol FORM One or more positive arithmetic 
expressions separated by commas 


Symbol or blank Formname | Exp,exp,. . .,exp 


Blank GBLA 1-35 set symbols separated by 
commas 


Blank GBLC 1-35 set symbols separated by 


commas 


Blank ICTL Two decimal arithmetic constants 
separated by a comma 
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Name 


Blank 


Symbol or blank 
Blank 


Sequence symbol or blank 
Sequence symbol or blank 
Sequence symbol or blank 


Sequence symbol or blank 


Sequence symbol or blank 


Sequence symbol or blank 
Set symbol 
Set Symbol 


Sequence symbol or blank 
Symbol or blank 
Symbol or blank 


Symbol or blank 


Operation 


ISEQ 


LTORG 
MACRO 


MEND 


MEXIT 
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Operand 
Blank, or two decimal arithmetic 
constants separated by a comma 
Not used 


Not used — ignored by the 
assembler 


Not used — ignored by the 
assembler 


Not used — ignored by the 
assembler 


Severity code, message or 
message only 


Absolute arithmetic expression 


F. MACRO EXAMPLE 


The example in Figures F-1 through F-3 demonstrates the use of the FORM instruction, but 
may serve as a model for many macro language and conditional features. It shows the 
comprehensive definition for a system macro, and two MACRO instructions for that macro. 
Two are included because the definition generates some code unique to the first call. 


The formal parameter list of the definition identifies expected parameters from the call: 
IDENT, LABDEF, REWIND, USAGE, CONTROL, and LIST. Three of these (REWIND, 
USAGE, and CONTROL) have default values provided in the definition. The other three 
remain null in value, if the call does not provide an explicit value for them. 


By using relational expressions in SETA statements, the macro definition provides for the 
setting of many counters according to the parameter values provided. Hence, the first call in 
the example, whose parameter string is: IDENT=FILE1,USAGE=O, sets the counter &UO 
(line 00039) because USAGE=O was coded. 


Because of the default value YES for REWIND, counter &RY (line 00042) is also set. The 
default ANS for CONTROL sets counter &CCA (line 00045). Conversely, counters &LY 
(line 00021), &LN (line 00025), and &LB (line 00037) are zero, because the LABDEF and 
LIST parameters were not given values by the macro call. 


Note how the definition explicitly checks for failure to provide the IDENT parameter (lines 
00048-00053). If the user does not provide it in the call, its count is zero (K’&IDENT), 
&IDNO is set to 1, and the ADO statement (line 00050) generates the fatal MNOTE 
message. In the call examples, IDENT=FILE1, the count (K’&IDENT) is 5 and &IDNO is 
not set. By similar means, the definition checks to ensure that specifications for the other 
parameters are correct. 


When all the incoming parameter values are verified and the appropriate conditional 
counters are set or reset, the macro generates the I/O packet with a FORM statement to 
designate the principal options. 


In line 00003, the macro declares the count field (@DMOCCNT) as global, and tests it for a 
zero (default) value. If it is zero, line 00005 sets it to 1. In this way, the macro determines 
whether the call is the first call within the assembly. This allows the once-only definition of 
the FORM instruction: $DMFRM, consisting of eight one-bit fields (line 00007). (Also note 
the use of the same code to generate an external for $DMOCC (line 00006), an external 
subroutine.) 


The FORM reference is generated through the $F1 SETC (line 00069), which creates the 
character string $DMFRM to be used at line 00072. In the operand fields of the FORM 
reference, SETA references pick up the counters established by earlier conditional 
instructions. 


In the first call shown, USAGE=O sets &UO=1 and REWIND=YES (default) sets &RY=1. 
Since the operand string of the &F1 statement was &CCN,0,0,0,&VO,&VV,&RY,&LB, the 
$DMFRM generates 0,0,0,0,1,0,1,0 as shown in the call expansion. In the second call, 
USAGE=U sets &UV=1, REWIND=YES (default) sets &RY=1, and the $DMFRM generates 
0,0,0,0,0,1,1,0. 


PRINT FUNCTION: DATE=72304 TIME=074604. 


OPENL MAC LISTING 
00001 MACRO 
00002 &TAG OPENL &IDENT=,&LABDE F=,2REWIND=YES,&USAGE=1,&CONTROL=ANS,&LIST= 
00003 GBLA &DMOCCNT 
00004 ADO &DMOCCNT < EQ>0, .DMOPIO SET GLOBAL FORM 
00005 &DMOCCNT SETA 1 AND EXTERNAL 
00006 EXTRN &DMOCC FIRST TIME 
00007. &DMFRM FORM 1,1,1,1,1,1,1,1 
00008 .DMOPIO ANOP 
00009 ADO K'&TAG <EQ>0, .DMOP15 SET 6 BYTE 
00010 &TAG1 SETC C'DN’ TAG FOR LABEL 
00011 &TG SETC &SYSNDX 
00012 AGO -DMOP25 PREFIX ON FIELDS OF 
00073. .DMOP15 ANOP THE LIST 
00014 &TG SETC Cc ° 
00015 ADO K’&TAG < LE >6, .DMOP20 
00016 &TAG1 SETC &TAG 
00017 AGO -DMOP25 
00018 .DMOP20 ANOP 
00019 &TAG1 SETC &TAG(1,6) 
00020. .DMOP25 ANOP 
00021 &LyY SETA &LIST <EQ>C’YES’ LIST=YES 
00022 ADO &LY,.DMOP30 
00023 AGO -DMOP50 
00024 .DMOP30 ANOP 
00025 &LN SETA &LIST< EQ >C’NO’ LIST=NO OR OMITTED 
00026 &TAG LODD OPED&SYSNDX,@7 SET RETURN INTO SAVE AREA 
00027 ADO &LN, .DMOP40 
00028 BCH @$DMOCC REG 6 ALREADY POINTS TO PACKET 
00029 AGO MEXIT 
00030 .DMOP40 ANOP 
00031 BSR @$DMOCC,6 SET REG 6 AT PACKET 
00032 AGO -DMOP55 
00033. .DMOP5O ANOP 
00034 &TAG ALIGN 2 
00035 .DMOP55 ANOP 


Figure F-1. Macro Definition 
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00036 
00037 
00038 
00039 
00040 
00041 
00042 
00043 
00044 
00045 
00046 
00047 
00048 
00049 
00050 
00051 
00052 
00053 
00054 
00055 
00056 
00057 
00058 
00059 
00060 
00061 
00062 
00063 
00064 
00065 
00066 
00067 
00068 
00069 
00070 
00071 
00072 
00073 
00074 
00075 
00076 
00077 
00078 
00079 
00080 
00081 
00082 
00083 
00084 
00085 
00086 
00087 
00088 


* CHANGE MADE PER PTR 333 06/16/72 DJS 


&LB 
&UI 
&U0 
&UU 
&USG 
&RY 
&RN 
&REW 
&CCA 
&CCN 
&CNTRL 
&IDNO 
&ERR 


&ERR 
-DMOP60 


&ERR 
-DMOP65 


&ERR 
.DMOP70 


&ERR 
-DMOP73 


-DMOP75 
&F1 


&TAGI.BT&TG &F1 
&TAGI.ER&TG WDD 


&TAG1.BD&TG WDD 


SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
SETA 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
MNOTE 
SETA 
ANOP 
ADO 
AGO 
ANOP 
SFTC 
WDD 
BDD 


BDD 
BDD 


BDD 
BDD 
ADO 


K’&LABDEF <GE>1 SET COUNTERS 
&USAGE< EQ>C’'T1’ DEPENDING 
&USAGE<EQ>C’0’ ON : 
&USAGE<EQ>C’'U’ KEYWORD 
&UIt&U0+&UU NE 1 SPECIFICATIONS 


&REWIND<EQ>C’YES’ 
&REWIND<EQ>C’NO’ 
&RY+&RN<CNE>1 
&CONTROL<EQ>C’ANS’ 
&CONTROL<EQ>C’NATIVE’ 
&CCA+&CCN<NE>1 
K’&IDENT<LT>1 

0 

&IDNO, .DMOP60 FATAL IF IDENT MISSING 
F,***IDENT KEYWORD MISSING*** 
1 


&USG, .DMOP65 
F,***USAGE=&USAGE INCORRECT SPECIFICATION *** 
1 


&REW, .DMOP70 
F,***REWIND=&REWIND INCORRECT SPECIFICATION *** 
1 


&CNTRL, .DMOP73 
F,***CONTROL=&CONTROL INCORRECT SPECIFICATION*** 
1 


&ERR, .DMOP75 


MEXIT 

C’&DMERM’ 

“7 LENGTH OF PACKET (WORDS) 

S'04' OPEN 
&CCN,0,0,0,2U0,8UU,&RY &LB OPTION BITS 

“0 ERROR RETURNED HERE 

X’00’ N/A 

&SYSEG SEGMENT TAG 

&IDENT PIR TO BDT 

X‘00' N/A 

&SYSEG SEGMENT TAG 

&LB, .DMOP80 LABEL PARAMETER 


**** CHANGE 06/21/72 PIR 4351 DJS 
&TAG1.LB&TG WDD &LABDEF 


-DMOP80 


AGO 
ANOP 


MEXIT 


**#** CHANGE 06/21/72 PTR 4351 DJS 


&TAGI.LB&TG WDD 


MEXIT 


OPED&SYSNDX EQU * 


ANOP 


MEND 


“0 


CODED 
RETURN HERE 


LBINOO10 LIBRARY FUNCTION COMPLETE 


Figure F-1. Macro Definition (Continued) 


052E 
0532 


0536 
0538 
0539 
053A 
053C 
053D 
O53E 
0540 
0541 


0542 


05A4 
O5A8 


O5AC 
OSAE 
O5AF 
05B0 
05B2 
05B3 
OSB4 
O5B6 
05B7 


CS5SB8 


BOOF0544 
EA860000 


BOOFO5BA 
EA860000 


0224 

0227A 
0228A 
0239A 
0242A 
0245A 
0270A 
0271A 
0272A 
0273A 
0274A 
0275A 
0276A 
0277A 
0278A 
0281A 
0282A 
0284A 


0408 

0420A 
0423A 
0426A 
0451A 
0452A 
0453A 
0454A 
0455A 
0456A 
0457A 
0458A 
0459A 
0462A 
0463A 
0465A 


$DMFRM 


DMBTO0002 
DMERO002 


DMBD0002 


DMLBO0002 


OPENL IDENT=FILE1 USAGE=0 
EXTRN &DMOCC 
FORM 11111111 
LODD OPEDO0002 @7 
BSR @$DMOCC 6 
* CHANGE MADE PER PTR 333 06/16/72 DJS 
WwDD “7 
BDD x’04 
&DMFRM _— 0,0,0,0,1,0,1,0 
WDD “0 
BDD x‘00’ 
BDD $SYSEG 
wDD FILE1 
BDD X‘00’ 
BDD $SSYSEG 
**** CHANGE 06/21/72 PTR 351 DJS 
WDD “0 
EQU * 


OPEDO002 


Figure F-2. Macro Instruction and Expansion (Call 1) 


OPENL 
LODD 
BSR 


IDENT=FILE1,USAGE=U 


OPEDO0005,*7 
@$DMOCC,6 


* CHANGE MADE PER PTR 333 06/16/72 DJS 


DMBTO005 
DMEROO005 


DMBDO0005 


WDD 
BDD 
&DMFRM 
WDD 
BDD 
BDD 
WDD 
BDD 
BDD 


“7 
x'04’ 
0,0,0,0,0,1,1,0 
“0 

X‘00" 
$SYSEG 
FILE1 

X‘00" 
$SYSEG 


**** CHANGE 06/21/72 PTR 351 DJS 


DMLBO0005 
OPEDO005 


Figure F-3. Macro Instruction and Expansion (Call 2) 


WDD 
EQU 


“0 


* 


FIRST TIME 


SET RETURN INTO SAVE AREA 
SET REG 6 AT PACKET 


LENGTH OF PACKET (WORDS) 
OPEN 

OPTION BITS 

ERROR RETURNED HERE 
N/A 

SEGMENT TAG 

PTR to BDT 

N/A 

SEGMENT TAG 


RETURN HERE 


SET RETURN INTO SAVE AREA 
SET REG 6 AT PACKET 


LENGTH OF PACKET (WORDS) 
OPEN 

OPTION BITS 

ERROR RETURNED HERE 
N/A 

SEGMENT TAG 

PTR TO BDT 

N/A 

SEGMENT TAG 


RETURN HERE 


G. ASSEMBLER ERROR MESSAGES 


The Assembler issues two types of errors. They are source error diagnostic messages and 
source error abort messages. Also listed in this section are the system messages that cause 
the Assembler to abort. 

ASSEMBLER SOURCE ERROR DIAGNOSTIC MESSAGES 


The assembler source errors are printed at the end of the listing. 


The messages have the following format: 


LINE ERROR ERROR 
NUMBER _TYPE _ CODE MESSAGE TEXT 
nnnn t aappnnn text * insert * text 
where: 
nnnn is a 4-digit decimal number that refers to the line in the 


source listing where the error occurred. 


t is either W designating the error as warning or F desig- 
nating the error as fatal. 


aappnnn is a 7-character error code where aa is always AS 
specifying the Assembler as the source of the error, 
pp is a 2-digit decimal number indicating the pass of 
the Assembler during which the error occurred, and 
nnn is a 3-digit decimal number specifying the error 
within the pass. 


text « insert * text is the text of the message. If the text contains an insert, 
an asterisk precedes and follows the insert. An insert 
contains the erroneous character and all characters back 
to the beginning of the invalid term. For example, if 
the listing contains an invalid variable symbol, such as 
&8PAM, the insert will contain the characters &8. 


The error messages and their explanations follow. 


G-1 


LINE 


NUMBER 


nnann 


nnnan 


nnann 


nann 


nnan 


nnnan 


nnnn 


nnann 


nann 


nnann 


Annn 


nnann 


nnnn 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS02001 


AS02002 
AS02003 


AS02004 


AS02005 


AS02006 


AS02007 


AS02008 


AS02009 


AS02010 


AS02011 


AS02012 


AS02013 


MESSAGE TEXT 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM. 

This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or number of 
operands. 


UNMATCHED RIGHT PARENTHESIS. 
UNMATCHED LEFT PARENTHESIS. 


EXPRESSION OR SUBLIST CONTAINS AN 
INVALID COMMA. 


INVALID SYNTAX «.. .insert. . .* 
An invalid element or combination of 
elements appear. 


INVALID USE OF INDIRECTION. 
*,..Insert. ..* 

The use of the indirect operator, @, is 
invalid. 


INVALID EXPRESSION «.. .insert. . .* 
The syntax does not follow the rules for 
coding expressions. 


INVALID USE OF LITERALS «.. .insert. . .« 
The use of the literal operator, =, is invalid 
in this statement. 


INVALID USE OF PARENTHESIS 
*,. insert. ..* 


CHARACTER STRING INVALID WITH 
+-* OR/ OPERATOR «.. .insert. . .* 
Arithmetic operations are invalid with strings. 


INVALID SUBLIST *.. .insert. . .* 
The use of the sublist is invalid in this 
statement. 


RELOCATABLE TERM USED IN MULTI- 
PLICATION, DIVISION OR LOGICAL 
OPERATION «.. .insert. . .* 

The location counter, *, may not enter into 
the above mentioned operations. 


MAY NOT FOLLOW A LOGICAL, RELA- 
TIONAL OR ARITHMETIC OPERATOR 
*,. insert. . .* 

The unary operator NOT may not follow 
the above mentioned operators. 


LINE ERROR ERROR 
NUMBER TYPE CODE MESSAGE TEXT 


NOTE: AS02014 and AS02015 are reserved for future use. 


nnnn F AS02016 SYMBOL TOO LONG «.. .insert. . .* 
The name entry or a symbolic operand 
may not exceed 8 characters. 


nnnn F AS02017 INVALID HEXADECIMAL CONSTANT 
*,..insert. ..* 
A hexadecimal constant may only contain 
digits 0-9 and characters A-F. 


nnnn F AS02018 QPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 
This message indicates internal stack over- 
flow. To correct the condition, reduce the 
number of terms itn the expression or the. 
number of operands. 


nnnn F AS02019 © INVALID OPERATOR +«.. .insert. . .* 


The operator or symbol is not in the 
language. 
nnnn F AS02020 INVALID CHARACTER «.. .insert. . .* 


The character is not in the language or is 
contextually incorrect. 


nnnn F AS02021 INVALID CONTINUATION «.. .insert. . .* 
The usage of the semicolon is contextually 
invalid. 

nnnn F AS02022 INVALID SYMBOL «.. .insert. . .* 
The length attribute operand may only be 
symbolic. 

nnnn F AS02023 INVALID STRING «.. .insert. . .* 


An invalid string structure appeared. 


NOTE: AS02024 is reserved for future use. 


nnnn F AS02025 INVALID STRING «. . .insert. . .* 
Same as AS02023 above. 
nnnn W AS02026 OPERAND TRUNCATED — TOO LONG 


*,. .insert. . .* 

The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the maxi- 
mum. For an integer string, 10 is the maxi- 
mum. For a hexadecimal constant, 4 is the 
maximum. 


nnnn W AS02027 VALUE TRUNCATED — EXCEEDS PER- 
MISSIBLE MAGNITUDE «.. .insert. . .* 
A decimal integer may not exceed 65,535. 
An integer string may not exceed 268,435,455. 


G-3 


LINE 


NUMBER 


nanan 


nnann 


nnann 


nann 


nnann 


nnann 


nnnn 


nnnn 


nnnn 


nann 


nanan 


nnnn 


nnnan 


nanan 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS02028 


AS02029 
AS02030 


AS02031 


AS02032 


AS02033 


AS02034 


AS02035 
AS02036 


AS02037 


AS02038 


AS02039 


AS02040 


AS02041 


G-4 


MESSAGE TEXT 


OPERAND ENTRY MISSING. 
The operation code in this statement 
requires an operand field entry. 


CONTINUATION LINE IS BLANK. 


TOO MANY CONTINUATION STATEMENTS. 
In a normal statement, only one continued 
statement is allowed. 


VARIABLE SYMBOL MUST START WITH & 
FOLLOWED BY A-Z OR §. 


LEFT PARENTHESIS MAY NOT BE 
IMMEDIATELY PRECEDED BY A 
VARIABLE SYMBOL. 


VARIABLE SYMBOL MUST START WITH & 
FOLLOWED BY A-Z OR §. 


VARIABLE SYMBOL TOO LONG. 
The variable symbol is greater than 7 characters 
excluding the ampersand sign. 


.* COMMENT VALID ONLY WITH A MACRO. 


CHARACTER THAT FOLLOWS. OR & MUST 
BE A-Z OR §. 

Period or & is followed by a numeric or an 
illegal character in the name field. 


NAME ENTRY TOO LONG. 
In an ordinary symbol, only 8 characters are 
allowed and in a sequence or variable symbol 
only 7 characters are allowed. 


INVALID CHARACTER IN NAME ENTRY. 
Only characters allowed are A-Z, 0-9 and $. 
For a sequence or variable symbol, the first 
character must be . or & respectively. 


OPERATION ENTRY MISSING. 
An operation entry is required in every state- 
ment. 


NAME ENTRY CANNOT BE CONTINUED. 


NAME ENTRY MUST BE FOLLOWED BY A 
SPACE. . 

The space is the delimiter of each field in the 
MRX Assembler. 


LINE 


NUMBER 


nann 


nnann 


nnann 


nanan 


nnann 


nann 


nnann 


nnann 


nann 


ERROR 


TYPE 


F 


ERROR 


_CODE_ 


AS02042 


AS02043 
AS02044 


AS02045 


AS02046 


AS02047 


AS02048 


AS02049 


AS02051 


MESSAGE TEXT 


OPERATION ENTRY MUST BE FOLLOWED 
BY A SPACE. 

The space is the delimiter of each field in the 
MRX Assembler. 


OPERATION CODE CANNOT BE CONTINUED. 


INVALID CHARACTER IN OPERATION 
ENTRY. 
Only valid characters are A-Z, 0-9, & and §$. 


OPERATION ENTRY TOO LONG. 
Only 8 characters are allowed if there is no 
substitution in the operation entry. 


INVALID ISEQ PARAMETERS — COMMAND 

IGNORED. 

1. The parameter value is within the begin 
and end limits in the statement. 

2. The length of the sequence field is zero. 

3. The length of the sequence field is greater 
than 8 characters. 


MISPLACED ICTL STATEMENT. 
An ICTL statement must be the first statement 
of an assembly. 


STATEMENT VALID ONLY WITHIN A 
MACRO. 
The following operation codes are allowed 
within a macro definition: 

GBLA 

GBLC 

MACRO 

MEND 

MNOTE 

MEXIT 


INVALID OR MISPLACED INSTRUCTION IN 
MACRO DEFINITION. 
The following operation codes are not allowed 
within a macro definition: . 

PRINT 

ISEO 

MACRO 
Also GBLA, GBLC must immediately follow the 
macro definition prototype. 


INVALID CONTINUATION. 
The continued statement has a continuation 
character as the first nonblank character. 


LINE 


NUMBER 


nann 


nnnan 


nann 


nann 


nnnn 


nnnn 


hnnnn 


naan 


nvann 


nann 


nnnan 


“ANNAN 


nnnn 


nnnn 


nann 


ERROR 
TYPE 


Ww 


Ww 


ERROR 


CODE 


AS02052 


AS02053 


AS02054 


AS02055 


AS02056 


AS02057 


AS02058 


AS02059 


AS02060 


AS02061 


AS02062 


AS02063 


AS02064 
AS02065 


AS02066 


MESSAGE TEXT 


END STATEMENT SUPPLIED BY ASSEMBLER. 
End of input detected but no end card received. 


NAME FIELD OF MEND STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 


NAME FIELD OF MACRO DEFINITION 
HEADER MUST BE BLANK. 

The name of the operation code MACRO 
must be blank. 


REQUIRED OPERAND ENTRY MISSING. 
The operation code in the statement requires 
an operand field entry. 


SYMBOLIC PARAMETER CANNOT BE 
USED AS A GBLA OR GBLC OPERAND. 


SET SYMBOL MAY NOT BE DEFINED AS 
BOTH SETA AND SETC. 


END QUOTE MISSING. 


MACHINE AND ASSEMBLER OPERATION 
CODES MAY NOT BE USED AS MACRO 
INSTRUCTION. 


MULTIPLE DEFINITION OF MACRO 
INSTRUCTION. 
Macro instruction has been previously defined. 


NAME ENTRY OF MACRO PROTOTYPE 
STATEMENT MUST BE BLANK OR A 
VARIABLE SYMBOL. 


MORE THAN 35 SYMBOLIC PARAMETERS. 
Only 35 symbolic parameters are allowed. 


NAME ENTRY OF MACRO INSTRUCTION 
MAY NOT BE A VARIABLE SYMBOL. 


STATEMENT OUT OF SEQUENCE. 


INVALID ISEO SYNTAX. 

In an ISEQ statement the name entry must be 
blank and the parameters must be separated by 
a comma and must be terminated by a space. 


INVALID ICTL SYNTAX. 
In an ICTL statement the name entry must be 
blank. 


LINE 


NUMBER 


nnann 


nAnnn 


nann 


nnn 


nann 


nnann 


“AANN 


nnann 


nann 


nnann 


nann 


ERROR 


TYPE 


1) 


W or F 


ERROR 


CODE 


AS02067 


AS02068 


AS02069 


AS02070 


AS02071 
AS02072 
AS02073 


AS02074 


AS02075 


AS02076 


AS02077 


MESSAGE TEXT 


NAME FIELD OF GBLA AND GBLC 
STATEMENTS MUST BE BLANK. 


OPERAND SYNTAX ERROR. 

An invalid character is in the operand field 
or invalid termination of a sublist, etc., 
appears in the operand field. 


OPERAND LENGTH ERROR. 
The maximum number of characters allowed 
per operand is 127. 


MORE THAN 35 OPERANDS. 

Only 35 operands are allowed in a macro 
prototype or a GBLA or GBLC statement or 
a macro definition instruction statement. 


NAME ENTRY MAY NOT BE A SEQUENCE 
SYMBOL. 


NAME FIEL D MUST CONTAIN A SET 
SYMBOL. 


SET SYMBOL MAY NOT BE DEFINED AS 
BOTH SETA AND SETC. 


MNOTE «.. .insert. . .* 

An MNOTE Assembler instruction has been 
encountered. The MNOTE message is output 
to the error file and processing continues. 


VALUE OF OPERAND EXCEEDS 65535. 

A number being converted from EBCDIC to 
binary has a value greater than +65535. The 5 
least-significant digits are converted to binary 
and only the least-significant 16 bits of the 
result are retained. 


INVALID ADO EXPRESSION. 

The expression in the operand field of this 
ADO instruction did not resolve to an 
integer of value between O and 65535. The 
ADO statement is not processed. 


IMPROPER ADO TERMINATION. 

1. The sequence symbol in the name field 
of this ADO statement terminates the 
currently active ADO loop. The currently 
active ADO loop is unstacked and the 
ADO statement is not processed. 


LINE 


NUMBER 


nnnn 


nann 


nnnan 


nann 


nann 


ERROR 


TYPE 


ERROR 


CODE 


AS02078 


AS02079 


AS02080 


AS02081 


AS02082 


MESSAGE TEXT 


2. The sequence symbol in the name field 
of this macro instruction terminates the 
currently active ADO loop. The 
currently active ADO loop is unstacked. 

3. A MEXIT or MEND instruction has been 
encountered, and the currently active 
ADO loop is at the current macro nesting 
level. The currently active ADO loop is 
unstacked. 


SECOND ADO OPERAND MISSING. 
The sequence symbol is missing from the 
operand field of this ADO statement. The 
ADO statement is not processed. 


BACKWARD BRANCH IN ADO OR AGO. 
The statement which contains the sequence 
symbol referred to in this ADO or AGO 
statement precedes the current statement. 
The ADO or AGO statement is not 
processed. 


INVALID CONTINUATION. 

1. Substitution into a source statement 
cannot be completed without generating 
more than one continuation line. Sub- 
stitution is discontinued. 

2. Substitution into a form reference 
cannot be completed without generating 
more than one continuation line. The 
statement is not processed. 


DUPLICATE DEFINITION OF VARIABLE 

SYMBOL. 

1. A variable symbol defined in a macro 
instruction is already in the local symbol 
table at the current macro nesting level. 

2. &SYSECT or &SYSND«X is already in the 
local symbol table at the current macro 
nesting level. 

The value already in the symbol table is 

retained. 


DUPLICATE FORM DEFINITION. 

More than one definition was encountered 
for the current form. The form definition 
is dropped. 


LINE ERROR . ERROR 
NUMBER TYPE — ~ CODE MESSAGE TEXT 


nnnn F AS02083 INVALID SEQUENCE SYMBOL. 
1. Sequence symbol does not start with a 
period .followed:by a letter or $. 
2. Sequence symbol is not 1-8 characters 
followed by a space. 
The instruction is replaced with ERR. 


nnnn F AS02084 _. INVALID FORM SYNTAX. 
The form reference contains a keyword 
parameter or a sublist parameter. The form 
reference is dropped. 


nnnn F AS02085 UNDEFINED SET SYMBOL OR SYMBOLIC 

PARAMETER. 

1. Set symbol or symbolic parameter is 
not found in symbol table. Substitute 
null value for missing value. 

2. Global set symbol is not found in 
symbol table. The ADO statement is 
not processed. 

3. Global set symbol is not found in 
symbol table. The SETA or SETC 
statement is not processed. 


nnnn F AS02086 INVALID SUBSTITUTION OF SEMICOLON. 
The first character of the value assigned to a 
variable symbol is a semicolon, and the 
character which would immediately precede it 
in the substitution record is not an escape 
character (_ ). Substitute null for the value. 


nnnn F AS02087 UNDEFINED MACRO. 

. 1. The operation code in a statement 
created by substitution is neither an 
ordinary instruction nor a form 

_ instruction. 
2. The operation code in this statement 
is neither an ordinary instruction nor 
a form instruction, nor can it be found 
in the macro library. 
The instruction is replaced by ERR. 


nnonn F AS02088 INVALID NAME ENTRY. 

1. Symbol in the name field of record 
created by substitution is either too 
long or contains an invalid character. 

2. Name field of form definition is either 
an instruction mnemonic or it is not an 
ordinary symbol. 


LINE ERROR ERROR 
NUMBER TYPE CODE MESSAGE TEXT 


3. Statement has nonblank name field. 

4. Statement has nonblank name field 
which is not a sequence symbol. 

5. Statement has nonblank name field 
which is not an ordinary symbol or 
a sequence symbol. 

6. Name field of ADO statement contains 

an ordinary symbol. 

7. Name field of SETA statement does not 
contain a SETA symbol. 

8. Name field of a SETC statement does 
not contain a SETC symbol. 

For conditions 1, 3, 4, 5, and 6, the name 

field is ignored. For condition 2, form 

definition is not processed. For conditions 

7 and 8, SETA and SETC statements are 

not processed. 


nnon F AS02089 ADO OR AGO OPERAND MUST BEA 
SEQUENCE SYMBOL. 
The ADO or AGO statement is not processed. 


nnnn F AS02090 &SYSNDX NOT IN SYMBOL TABLE. 
Assembler logic error. The SETA and SETC 
statement is not processed. 


nnnn F AS02091 MORE THAN FIVE LEVELS OF MACRO 
NESTING. 
The instruction is replaced by ERR. 


nnnn F AS02092 OPERAND LENGTH ERROR. 
Length of operand or suboperand exceeds. 
127 bytes. The operand is replaced by null. 


nnnn F AS02093 TOO MANY OPERANDS. 

1. |More operands are in a macro call than 
there are parameters in the prototype. 

2. AGO, SETA, or SETC statement 
contains more than one operand. 

3. ADO statement contains more than 
two operands. 

The extra operands are ignored. 


nnnn F AS02094 MACRO DEFINITION ERROR. 
Macro instruction is replaced by ERR. 


nnnn F AS02095 TOO MANY LEVELS OF ADO NESTING. 
The ADO statement is not processed. 


G-10 


LINE 
NUMBER 


nnann 


nnnan 


nnann 


naAnn 


nnnn 


nnnn 


nnann 


ERROR 


TYPE 


F 


ERROR 


CODE 
AS02096 


AS02097 


AS02098 


AS02099 


AS02100 


AS02101 


AS02102 


MESSAGE TEXT 


INNER ADO LOOP MUST BE COMPLETELY 
CONTAINED WITHIN THE OUTER ADO 
LOOP. 

Processing of the outer ADO loop is discontinued. 


INVALID PRINT OPERAND. 

1. | The operand field is terminated by a comma 
or semicolon. 

2. One of the operands is not “OFF, ON, 
NOGEN, GEN, NODATA, DATA, 
NOCOND, OR COND.” 

The remainder of the operand is ignored and the 

assembly process continues, using the last valid 

operand processed for each option. 


MACRO INSTRUCTION MAY NOT HAVE 
BOTH POSITIONAL AND KEYWORD 
PARAMETERS. 

The macro instruction is not processed. 


MACRO INSTRUCTION USED AS FORM 
NAME. 

The name field of a form definition which 
was created by substitution contains a 
rnnemonic that has been identified as a 
rnacro instruction. The form definition | 

is not processed. 


INVALID SET EXPRESSION. 

1. The operand field of SETA instruction 
contains a nonnumeric character. 

2. The value of a SETA expression eKCceo 
65,535. 

3. The operand field of aSETA or SETC 
instruction contains a sublist or a 
sequence symbol. 

The SETA or SETC instruction is not processed. 


REFERENCE TO UNDEFINED SET SYMBOL. 
This is an Assembler logic error. 


INVALID SUBSTITUTION. 

1. |The symbol whose value is to be used in 
substitution is not aSETA, aSETC, a 
symbolic parameter, or &SYSNDX. This 

is an Assembler logic error. The value is 
replaced by null. 

The name field of a statement created by 
substitution contains a sequence symbol. 
The name field of the statement is ignored. 


LINE 


NUMBER 


nnann 


nnnan 


nnnan 


nnann 


nnann 


nnAN 


nanan 


nnnn 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS02103 


AS02104 


AS02105 


AS02106 


AS02107 


AS02108 


AS02109 


AS02110 


MESSAGE TEXT 


REFERENCE TO &SYSNDX VALID ONLY 
WITHIN A MACRO. 
The SETA or SETC statement is not processed. 


REFERENCE TO UNDEFINED FORM. 
Reference to a form instruction whose definition 
has not yet appeared in the generated source. 
The instruction is replaced by ERR. 


UNDEFINED KEYWORD OPERAND. 

1. |The macro instruction has more operands 
than the macro prototype has parameters. 

2. The macro instruction has at least one 
operand whose name does not match any 
of the prototype’s keyword parameters. 

The extra operands are ignored. 


REFERENCE TO UNDEFINED SEQUENCE 
SYMBOL. 
The ADO or AGO statement is not processed. 


INVALID SUBSTITUTION INTO OPERATION 
ENTRY. 

The instruction in this substitution record was 
one which may not be created by substitution. 
The instruction is not processed. 


MORE THAN 35 SUB-OPERANDS. 
This is an Assembler logic error. 


OPERATION ENTRY MISSING. 

1. The statement created by substitution is 
all blank after the name field. 

2. Thestatement created by substitution 
has a continuation character immedi- 
ately after the name field. 

The instruction is replaced by ERR. 


INVALID OPERATION ENTRY. 

1. The operation code in the statement 
created by substitution is more than 
eight characters long. 

2. The operation field in the statement 
created by substitution contains an 
invalid character. 

3. The operation code in the statement 
created by substitution is continued 
on the second line of the statement. 

The instruction is replaced by ERR. 


LINE ERROR ERROR 
NUMBER TYPE CODE MESSAGE TEXT 

nnnn F AS02111 REFERENCE TO DOUBLY-DEFINED 
SEQUENCE SYMBOL. 
The ADO or AGO statement is not processed. 

nnnn F AS02112 INSTRUCTION NOT VALID AFTER SEG 
STATEMENT. 
The instruction is not processed. 

nnnn W AS02114 SPECIFIED SUBSTRING — LENGTH TOO 


LARGE. 
NOTE: AS02115 reserved for future use. 
nnnn F AS02116 INVALID USE OF SEQUENCE SYMBOL. 
NOTE: AS02117 reserved for future use. 
nnnn F AS02118 INVALID USE OF CHARACTER STRING. 
NOTE: AS02119 reserved for future use. 


NOTE: AS02120 reserved for future use. 


NOTE: AS02121 and ASO2122 reserved for future use. 

nnnn F AS02123 EXPRESSION CONTAINS INCOMPATIBLE 
OPERAND TYPES. 

nnnn F AS02124 EVALUATOR — STACK OVERFLOW. 

nnnn F AS02125 MULTIPLICATION OR DIVISION OVERFLOW. 

nnnn F AS02126 UNDEFINED SEQUENCE SYMBOL OR 
VARIABLE SYMBOL. 

nnnn F AS02127 — INVALID SUBSTRING OR SUBLIST 
REFERENCE. 

nnnan F AS03001 OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM. 
This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or number of oper- 
ands. 

nnnn F AS03002 UNMATCHED RIGHT PARENTHESIS. 

nnnn F AS03003 UNMATCHED LEFT PARENTHESIS. 

nnnn F AS03004 EXPRESSION OR SUBLIST CONTAINS AN 


INVALID COMMA. 


LINE 


NUMBER 


NOTE: 


nanan 


nnann 


nnAn 


nnann 


nann 


nnnn 


nnan 


nnnan 


NOTE: 


nnnan 


nnann 


ERROR 
TYPE 


AS03005 reserved for future use. 


F 


ERROR 


CODE 


AS03006 


AS03007 


AS03008 


AS03009 


AS03010 


AS03011 


AS03012 


AS03013 


MESSAGE TEXT 


INVALID USE OF INDIRECTION 
*,..insert. . .* 
The use of the indirect operator, @, is invalid. 


INVALID EXPRESSION «.. .insert. . .* 


The syntax does not follow the rules for 
coding expressions. 


INVALID USE OF LITERALS «.. .insert. . .* 
The use of the literal operator, =, is invalid in 
this statement. 


INVALID USE OF PARENTHESIS 
*...Insert. . .* 


CHARACTER STRING INVALID WITH 
+-* OR / OPERATOR «.. .insert. . .# 
Arithmetic operations are invalid with strings. 


INVALID SUBLIST «.. .insert. . .* 
The use of the sublist is invalid in this 
statement. 


RELOCATABLE TERM USED IN MULTI- 
PLICATION, DIVISION OR LOGICAL 
OPERATION «.. .insert. . .* 

The location counter, *, may not enter into 
the above mentioned operations. 


MAY NOT FOLLOW A LOGICAL, RELA- 
TIONAL OR ARITHMETIC OPERATOR 
*,..insert. . .* 

The unary operator NOT may not follow the 
above mentioned operators. 


AS03014 and ASO3015 are reserved for future use. 


F 


AS03016 


AS03017 


SYMBOL TOO LONG +.. .insert. . .* 
A name entry or a symbolic operand may not 
exceed 8 characters. 


INVALID HEXADECIMAL CONSTANT 
*,..insert. ..* 

A: hexadecimal constant may only contain 
digits 0-9 and characters A-F. 


MESSAGE TEXT 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 

This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or the number of 


INVALID OPERATOR «.. .insert. . .* 
The operator or symbol is not in the language. 


INVALID CHARACTER «. . .insert. . .* 
The character is not in the language or is 
contextually incorrect. 


INVALID CONTINUATION «.. .insert. . .* 
The usage of the semicolon is contextually 


INVALID SYMBOL «.. .insert. . .* 
The length attribute operand may only be 


INVALID STRING «.. .insert. . .* 
An invalid string structure appeared. 


INVALID STRING «.. .insert. . .* 
Same as AS03023 above. 


OPERAND TRUNCATED — TOO LONG 


The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the 
maximum. For an integer string, 10 is the 
maximum. For a hexadecimal constant, 4 


VALUE TRUNCATED — EXCEEDS PER- 
MISSIBLE MAGNITUDE «.. .insert. . .* 

A decimal integer may not exceed 65,535. 

An integer string may not exceed 4,294,967,295. 


LINE ERROR ERROR 
NUMBER TYPE CODE 
nnnn F AS03018 
operands. 
nnnn F AS03019 
nnnn F AS03020 
nnnn F AS03021 
invalid. 
nnnn F AS03022 
symbolic. 
nnnn F AS03023 
NOTE: AS0300724 is reserved for future use. 
nnnn F AS03025 
nnnn W AS03026 
*,..Insert. . .* 
is the maximum. 
nnnn W AS03027 
NOTE: AS03028 and AS03029 are reserved for future use. 
nnnn W AS03030 


INVALID USE OF NAME ENTRY. 


LINE ERROR ERROR 
NUMBER TYPE CODE 
nnnn F AS03031 
nnnn F AS03032 
nnnn F AS03033 
nnnn F AS03034 
nnnn F AS03035 
nnnn F AS03036 
nnnn F AS03037 
NOTE: AS03038 is reserved for future use. 
nnnn F AS03039 
nnnn F AS03040 
nnnn F AS03041 
NOTE: AS03042 is reserved for future use. 


MESSAGE TEXT 


INVALID FORM DEFINITION. 
A form reference cannot be used as an operand 
entry. 


INVALID USE OF $SYSEG. 
$SYSEG is invalid in an evaluated expression. 


RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 

A relocatable term may not be used in con- 
junction with a NOT operator. 


INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 


RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR «.. .insert. . .* 
A relocatable term may not be used in con- 
junction with a multiplication, division, or 
logical operation. 


INVALID SYNTAX. 
The operand structure does not. follow the 
rules of the language. 


MORE THAN SIX RELOCATABLE TERMS. 
An expression may not contain more than six 
unresolved relocatable terms. 


INVALID STRING «.. .insert. . .« 
Both strings in a relational or logical operation 
must be the same type. 


OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 
The expression size is too large to be evaluated. 


MULTIPLICATION OR DIVISION OVER- 
FLOW «...insert...* 

Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 16-bit value. 


LINE 


NUMBER 


nnnn 


nnnn 


NOTE: 
NOTE: 


nnnn 


nnnan 


nanan 


nnnn 


NOTE: 
NOTE: 


nnnn 


nnnn 


nann 


ERROR 


F 


AS03045 is reserved for future use. 


TYPE 


ERROR 


CODE 
AS03043 


AS03044 


MESSAGE TEXT 


RELOCATABLE TERM INVALID WITH 
RELATIONAL OPERATOR ~«.. .insert. . .* 
A relocatable term may not be used in con- 
junction with a relational operator. 


UNDEFINED SYMBOLIC OPERAND. 
The reference is not used as a label within 
this program. 


AS03046 through AS03050 are reserved for future use. 


F 


AS03055 is the same as ASO3052. 


AS03051 


AS03052 


AS03053 


AS03054 


DUPLICATE DEFINITION OF NAME 
ENTRY. *...insert...* 

The name field entry definitions must be 
unique. All duplicates are discarded. 


ENTRY POINT DEFINITION IS NOT 
RELOCATABLE «.. .insert. . .* 

The entry point definition must resolve 
to a relocatable term. 


CSECT NAME IS ALREADY DEFINED, 
BUT NOT AS CSECT +.. .insert. . .* 
Control section names must not appear as 
ordinary name field entries. 


COM NAME IS ALREADY DEFINED, 
BUT NOT COM ~+«.. .insert. . .* 

COM names must not appear as ordinary 
name field entries. 


AS03056 through AS03058 are reserved for future use. 


F 


AS03059 


AS03060 


AS03061 


DUPLICATE FORM DEFINITION. «.. .insert. .. 


The form definition name entry is previously 
defined. 


INVALID SYNTAX IN STORAGE 
RESERVATION. 

The operand of a reserve storage instruction 
must be preresolved, absolute, positive arithme- 
tic expression. Only one operand is allowed. 


INVALID SYNTAX IN DATA DEFINITION. 
The syntactical structure of the data definition 
operand is invalid. 


LINE 


NUMBER 


nnnan 


nann 


nnnn 


nnnn 


nnann 


nnnn 


NOTE: 


nann 


nann 


nnnn 


nnnn 


nnnn 


ERROR 


F 


TYPE 


ERROR 


CODE 


AS03062 


AS03063 


AS03064 


AS03065 


AS03066 


AS03067 


MESSAGE TEXT 


INVALID USE OF INDIRECTION. 
An indirect operator is invalid in data 
definition operands. 


INVALID USE OF LITERAL. 
The literal operator is invalid in size or 
repetition field of a data definition operand. 


INVALID SIZE SPECIFICATION. 
The size operand of data definitions must 
be preresolved absolute expression. 


INVALID REPETITION FACTOR. 

The repetition factor of a data definition 
operand must be a preresolved absolute 
expression. 


VAL UE OF LOCATION COUNTER 
EXCEEDS 65,535. 


TRUNCATION OCCURRED. 

The implied size of the value operand is 
greater than the explicit size operand ina 
data definition. 


AS03068 through ASO3069 are reserved for future use. 


F 


AS03070 


AS03071 


AS03072 


AS03073 


AS03074 


INVALID USE OF $SYSEG. 
The data following $SYSEG definition must 
be two bytes long, word aligned, and relocatable. 


REQUIRED OPERAND ENTRY MISSING. 
This instruction requires an operand and none 
was supplied. 


INVALID SUBLIST. 
The syntax indicates a suboperand, but the 
instruction does not allow suboperands. 


INVALID USE OF LITERAL. 
The instruction does not allow a literal as an 
operand, but one was coded. 


INVALID USE OF INDIRECTION. 
The instruction does not allow indirection, 
but indirection was coded. 


LINE ERROR ERROR 


NUMBER TYPE | CODE MESSAGE TEXT 
nnnn F AS03075 _INVALID EXPRESSION. 


The expression coded does not fall within the 
types allowed. 
A string type was used where only 
arithmetic type expressions are allowed. 
2. Anunresolved expression was coded on 
an instruction which required expressions 
to be predefined. 
3. A relocatable expression is coded where 
only absolute are allowed. 


nnnn WwW. AS03076 NAME FIELD OF ORG STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 


nnnn W AS03077 INVALID RELOCATION. 
1. An absolute value was coded where a 
relocatable value was required. 
2. The relocation identifier does not 
match the relocation identifier for the 
control section in effect; e.g., trying to 
ORG to another CSECT or COM section. 


nnann F AS03078 NAME ENTRY REQUIRED ON AN EQU 
STATEMENT. 
nnann Ww AS03079 TOO MANY OPERANDS. 


More than the maximum number of operands 
allowable for this instruction were coded. The 
values of the first operands were used. 


nnnn F AS03080 ONLY SINGLE TERM RELOCATABLE 
EXPRESSIONS ARE VALID. 


nnnn F AS03081 COMBINED CSECT, COM AND EXTRN 
COUNT EXCEEDS 252. 
The binary generated will probably not be 
useless. Reduce the number of EXTERNs 
and CSECTs and COMs and reassemble. 


nnnn W AS03082 INVALID NAME ENTRY. 
The name entry was coded where none was 
allowed. The name entry has not been entered 
into the symbol! table. Any reference to it will 
result in an undefined reference. 


nnnn AS03083 REFERENCE TO INVALID FORM DEFINITION. 
1. The operation entry matches something other 
than a FORM definition. 
2. There was no such entry. 
3. No operand was coded on the reference. 


LINE 


NUMBER 


nnnn 


nnnn 


nnann 


nnann 


nnnn 


nnnan 


nnann 


nnnan 


nnnan 


nanan 


nann 


nnnn 


ERROR 


TYPE 


F 


ERROR 


CODE 


AS03084 


AS03085 


AS03086 


AS03087 


AS03088 


AS03089 


AS04001 


AS04002 


AS04003 


AS04004 


AS04005 


AS04006 


MESSAGE TEXT 


OPERAND SIZE EXCEEDS 255 BITS. 

A FORM definition was coded with an operand 
which did not resolve to an absolute value less 
than 255. 


DUPLICATE DEFINITION OF NAME ENTRY. 


NAME ENTRY REQUIRED ON A FORM 
DEFINITION. 


CSECT NAME MAY NOT DUPLICATE COM 
NAME. 

The name entries of CSECT and COM state- 
ments cannot duplicate each other in the same 
assembly. 


ONLY ONE TITLE STATEMENT INA 
PROGRAM MAY HAVE A NONBLANK 
NAME FIELD. 


INVALID PRIME ENTRY POINT. 

1. The operand of an END statement does 
not resolve to an even boundary. 

2. The operand does not reference a 
relocatable value. 


INVALID FORM DEFINITION. 
A form reference cannot be used as an operand 
entry. 


INVALID USE OF $SYSEG. 
$SYSEG is invalid in an evaluated expression. 


RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 

A relocatable term may not be used in 
conjunction with a NOT operator. 


INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 


RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR ~«.. .insert. . .* 

A relocatable term may not be used in conjunc- 
tion with a multiplication, division, or logical 
operation. 


INVALID SYNTAX. 
The operand structure does not follow the rules 
of the language. 


LINE ERROR ERROR 


NUMBER TYPE CODE MESSAGE TEXT 
nnnn F : AS04007 MORE THAN SIX RELOCATABLE TERMS. 


An expression may not contain more than six 
unresolved relocatable terms. 


NOTE: AS04008 is reserved for future use. 


nnnn F AS04009 INVALID STRING «.. .insert. . .* 
Both strings in a relational or logical operation 
must be the same type. 


nnnn F AS04010 OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM «.. .insert. . .* 
The expression size is too large to be evaluated. 


nnnn F AS04011 MULTIPLICATION OR DIVISION OVERFLOW 
*,. insert. . .* 


Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 16-bit value. 


NOTE: AS04012 is reserved for future use. 


nnnn F — AS04013 RELOCATABLE TERM INVALID WITH 
RELATIONAL OPERATOR «.. .insert.. .* 
A relocatable term may not be used in conjunction 
with a relational operator. 


nnnn F AS04014 UNDEFINED SYMBOLIC OPERAND. 
The reference is not used as a label within this 
program. 


NOTE: AS04015 reserved for future use. 
nnnn W AS04016 - TRUNCATION OCCURRED. 


The value coded exceeded the match field ona 
FORM definition. Normal rules of truncation 


are followed. 
nnnn W AS04017 TOO MANY OPERANDS. 
nnnn WwW AS04018 REQUIRED OPERAND ENTRY MISSING. 


Fewer operands were coded in a form reference 
than were coded in the FORM definition. 


nnnn F AS04019 INVALID RELOCATION-VALUE TREATED 
AS ABSOLUTE. 
1. The receive field was not 16 bits or was 
not on an even byte boundary. The number 
of relocation identifiers was greater than one. 
2. For $SYSEG, the receive field was not 8 bits 
long, or was not on a byte boundary. 
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LINE 


NUMBER TYPE 


nnanan 


NOTE: 


nnann 


nann 


nnann 


NOTE: 


nann 


nAann 


nann 


NOTE: 


nonnn 


nann 


nanan 


ERROR 


F 


AS04021 is reserved for future use. 


Ww 


Ww 


Ww 


AS04025 is reserved for future use. 


Ww 


AS04029 is reserved for future use. 


Ww 


ERROR 


CODE 


AS04020 


AS04022 


AS04023 


AS04024 


AS04026 


AS04027 


AS04028 


AS04030 


AS04031 


AS04032 


MESSAGE TEXT 


INVALID SYNTAX. 

The syntax of a FORM reference operand may 
have had one of the following errors: 

1. Indirection coded 

2. A sublist coded 

3. No operand was coded. 


TITLE OPERAND MUST BE A CHARACTER 
STRING. 


LENGTH OF TITLE OPERAND EXCEEDS 90 
CHARACTERS. 

The operand is truncated on the right to 90 
bytes and then used. 


SPACE OPERAND MUST BE A RESOLVED 
ARITHMETIC EXPRESSION. 


FORWARD REFERENCE TO STRING EQUATE 
— IMPLICIT STRING — LENGTH IS 2 BYTES. 
A data definition operand referencing a forward 
string equate is implicitly resolved to two bytes. 
Truncation or padding may have occurred. 


TRUNCATION OCCURRED. 
The implicit size of the value operand is greater 
than the explicit size operand in data definitions. 


INVALID RELOCATION — VALUE TREATED 
AS ABSOLUTE. 

A relocatable value must be on word boundary 
and two bytes in length. The number of relocation 
factors in an expression must be resolved to one. 


NOP SUBSTITUTED FOR INVALID 


OPERATION CODE. 


TOO MANY OPERANDS OR SUBOPERANDS. 
Refer to the MRX/OS Assembler Reference 
manual to determine the maximum number of 
operands. . 


INVALID INDIRECTION OR LITERAL USAGE. 


LINE 


NUMBER 


nnnn 


nann 


nnann 


nnnn 


nnann 


nann 


nnann 


nnann 


nnann 


nnann 


nnnn 


nann 


ERROR 
TYPE 


Ww 


ERROR 


CODE 


AS04033 


AS04034 


AS04035, 


AS04036 


AS04037 


AS04038 


AS04039 


AS04040 


AS04041 


AS04042 


AS04043 


AS04044 


MESSAGE TEXT 


LITERAL POOL SIZE EXCEEDS MEMORY 
LIMITS. 

The current literal pool is located at an address 
greater than 65,535. Binary generation is 
suppressed. 


INVALID USE OF STRING CONSTANT. 
A string constant may have been used as an 
address or as a register designator. 


LOSS OF SIGNIFICANCE. 
An immediate operand cannot contain the 
amount coded. 


INVALID RELOCATION. 
More than one relocatable value remains after 
evaluation. 


REQUIRED SUBOPERAND MISSING. 

An instruction which must have a certain 
minimum of operands or suboperands has 
been coded without one or more of them. 


VALUE NOT WITHIN RANGE OF 
DESIGNATED FIELD. 

The resolved value exceeds the maximum 
value, permitted. 


EXPLICIT USE OF REGISTER ZERO AS 

AN INDEX. 

Register zero has no effect as an index register, 
but it was coded as an index. 


TRUNCATION OCCURRED. 

A string constant used in a direct instruction 
exceeds 2 bytes. Normal rules of truncation 
are used. 


WORD BOUNDING REQUIRED. 
The instruction functions only on even bounded 
addresses, but an odd address was coded. 


RELOCATABLE TERM USED — ABSOLUTE 
VAL UE REQUIRED. 


EDIT LENGTH L2 MUST BE GREATER THAN 
L1 UNLESS L2 IS ZERO. 


INVALID USE OF $SYSEG. 
$SYSEG is not allowed as an operand or sub- 
operand of any machine instruction. 


LINE 


NUMBER 


nnnn 


nnann 


ERROR 


ae 2 


F 


ERROR 


CODE 


AS04045 


AS04046 
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MESSAGE TEXT 


INVALID ENTRY POINT. 

The entry point did not resolve to a relocatable 
value. Note that the line number is associated 
with the END statement because the fact cannot 
be discovered when the ENTRY instruction was 
encountered. 


MORE THAN 175 SEG DIRECTIVES 
ENCOUNTERED — FIRST 175 USED. 


ASSEMBLER ABORT MESSAGES 


The MRX/OS Assembler abort messages are printed as the final line(s) of the listing. The 
assembly is aborted when any of these messages appear. The messages and their explanations 
~ are given below. The format of the messages is exactly as presented. 


MESSAGES 


ERROR IN PHASE CALL. 
Assembler in error. 


ERROR IN I/O HANDLING. 


INPUT BLOCK SIZE EXCEEDS MEMORY AVAILABLE. 
The partition size is too small to handle the larger input block size. Increase the partition 
size for this input file. In 8K, the maximum input block size allowed is 86 bytes. 


PARTITION-SIZE LESS THAN 8K BYTES. 
The Assembler requires a minimum of 8K bytes to run. 


SYMBOL TABLE ERROR. 
Assembler in error. 


SYSTEM MACRO BLOCK SIZE TOO LARGE (GREATER THAN 86 BYTES). 


END OF INPUT OCCURRED WHILE PROCESSING A MACRO — MEND STATEMENT 
MISSING. 

Either an end of input or an END statement was detected while a macro definition was 
being processed. | 


FATAL ERROR IN ICTL STATEMENT PARAMETER. 
In an ICTL statement, the first parameter is less than 1 or greater than 40, or the second 
parameter is less than 40 or greater than 120. 


PARAMETER 


* : * 
DELIMITER ERROR IN COLUMN xx IN STATEMENT *.. .insert. . . 


PARAMETER CARD ERROR — JOB ABORTED. 

On a //PAR statement, either a parameter or a delimiter is in error. The contents of the 
//PAR statement, but not the characters //PAR, are printed as an insert between the 
asterisks. The column number, xx, indicates the erroneous character, column 1 being the 
first character between the asterisks. Several parameter or delimiter errors may be listed in 
succession before the PARAMETER CARD ERROR message. 


FATAL ERROR IN ICTL STATEMENT SYNTAX. 
The ICTL statement parameters must be separated by a comma and terminated by a space. 


G-25 


SPECIFIED IMEM NOT FOUND IN LIBRARY. 
Either the member name does not exist or the wrong library name was used. 


MEND STATEMENT MISSING IN SYSTEM MACRO. 
While processing a system macro definition an end of input was detected, but not a MEND 
statement. Check if the system macro library has been destroyed or if just one macro was 


incorrectly written on 


it. 


BINARY REQUESTED — BUT OMEM1 NOT SUPPLIED. 
A member name must be provided so that the binary may be entered in the object library 


under that name. 


OPERAND MISSING IN ICTL STATEMENT. 
An ICTL statement requires an operand entry. 


SYSTEM MESSAGES 


The following system messages cause the assembler to abort. 


ERROR CODE 


5021 


21nn 


24nn 


MESSAGE TEXT 


ILLEGAL BLOCK NUMBER. 

If the assembly process has not reached the print phase, the most 
probable cause is too smal! an allocation of MAXSIZ. Another 
possible cause is too small a file allocated for OMEM2. 


If the assembly process has reached the print stage, the most 
probable cause is that the binary file (OQUTPUT1) has been filled. 


These errors are probably caused by an error in the Control Language 
statements. 


These errors are probably caused by an error in the Control Language 
statements. Error 2109 indicates too large a MAXSIZ as a probable 
cause. Error 240B indicates that one or more of the user-supplied 
files is noncontiguous. The file with multiple extents must be 
recreated as a contiguous file. 
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INDEX. 


Abort messages 
Absolute 


expressions, definition of 
terms, definition of 
Addressing in machine instructions 


ADO statement 
AGO statement 
ALIGN statement 
Alignment 

of data 


of machine instructions 
Alphabetical list of machine 


instructions 
ANOP statement 
Arithmetic 
constants 
operators 
set expressions 


Assembler instructions 


definition 

overview 

summary 
Assembly options 


BDD statement 

Begin-end columns 
alteration of 
description 

BRS statement 

Byte reserve storage 

Byte defined data 


Calling assembler 
Card codes 
Character 

codes 

set 

set expression 

string constants 


Coding form 
format of 
statement continuation 
COM statement 
Comments 
Common control sections (see 


COM statement) 
Conditional assembly statements 


ADO 

AGO 

ANOP 

GBLA 

GBLC 

SETA 

SETC 
Constants 

arithmetic 

string 
Continuation of statements 
Control language for assembler 
Control sections 

and location counter 

assembler statements for 


Count attribute of macro instruc- 


tion operand 
Cross reference list, suppressing 
CSECT statement 


Data definition statements 
Diagnostic messages 


EBCDIC table 

EJECT statement 

END statement 

ENTRY statement 

EQU statement 

Error messages 
abort messages 
diagnostic messages 
system messages 
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Expressions 
absolute 
definition 
evaluation of 
relocatable 
Extended mnemonics 
EXTRN statement 


FORM definition statement 

FORM instruction statement 

GBLA statement 

GBLC statement 

General purpose machine instruc- 
tions 

Global arithmetic and character 

set symbols 


Hex codes of machine instruc- 
tions 
Hexadecimal string constants 


ICTL statement 
Identification-sequence field 
Index registers 

Input format control 

Integer string constants 
ISEQ statement 


Job control language (see 
Control language) 


Linkage editor 
and control sections 
and symbol linkage 
map directive (SEG) 
Linking statements 
Listing control statements 
EJECT 
PRINT 
SPACE 
TITLE 
Literal pools 
and LTORG statement 
description 
Literals 
description 
in WDD and BDD statements 


Location counter 
and ALIGN statement 
and ORG statement 
and WDD and BDD statements 
description 
reference (asterisk) 
Logical operators 
LTORG statement 


Machine instructions 
alphabetical list 
definition 
hex code to mnemonic 
object formats 
summary 
Macro language 
concatenation of variable 
symbols 
count attribute 
example 
file definition 
general description 
macro definition 
macro instruction 
MEXIT statement 
MNOTE statement 
nesting of macros 
number attribute 
sublists in macro instructions 
sublists in model statements 
substring notation 
system variable symbols 
(&@SYSNDX, &SYSECT) 
Messages, error 
Mnemonic definition (FORM) 


Name field, description 

Notation used to describe 
machine instructions 

Number attribute of macro 
instruction operand 


Object formats of machine instruc- 


tions 
Object program 
definition 
tile definition 
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Operand field, description 

Operating system, relationship to 
assembler 

Operation codes (hex) for 
machine instructions 

Operation field, description 

Operators 

Ordinary symbols 

ORG statement 


Packed decimal string constants 
PRINT statement 
Program 
control statements 
listing 
sectioning 
termination 
PUNCH statement 


Registers 
Relational operators 
Relocatable 
expressions, definition of 
symbols, identification of 
terms, definition of 
Reserving storage 


SEG statement 
Segment names (see SYSEG) 
Sequence checking statements 
Sequence symbols 
Set symbols 
SETA statement 
SETC statement 
Source program 
definition 
file definition 
listing control 
Source statements 
basic format 
character set 
coding form 
expressions 


Source statements (continued) 
terms 


SPACE statement 


String constants 

character 

hexadecimal 

integer 

packed decimal 

zoned decimal 
Symbol definition statements 
Symbol length attribute 
Symbolic linkage statements 
Symbols 

definition 

ordinary 

rules for using 

sequence 

variable 
SYSEG reserved name 
System 

machine instructions 

messages 

requirements for assembler 
TITLE statement 
Termination of assembly 
Terms 

constants 

definition 

literals 

location counter reference 

symbols 

symbol length attribute 


Variable symbols 


WDD statement 
Word defined data 
Word reserve storage 
Writing to disk file 
WRS statement 


Zoned decimal string constants 
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